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How to Use This Manual 

This manual introduces you to the RT-11 Version 5 software kit and tells 
you how to install your operating system. The modular structure of this 
manual allows you to read only the chapters that you need for your particu- 
lar combination of hardware and software. 

Chapter 1 of the manual introduces you to installation and system genera- 
tion concepts and helps you choose a reading path through the other chap- 
ters. 

Installation concepts — both planning activities and actual installation 
procedures — are covered in Chapters 2 through 11. You should read 
Chapter 2 to plan your installation, then choose the chapter (3, 4, 5, 6, 7, 8, 
9, 10 or 11) that describes the installation of a system most closely resem- 
bling your own configuration. 

Additional information available in the appendixes includes BATCH 
streams to build system programs and toggle-in software bootstraps. 

If you discover that you need to perform the system generation process, 
refer to the RT-11 System Generation Guide. 

Before you begin, you should read the Guide to RT-11 Documentation, 
which describes the other software documents associated with the RT-11 
operating system. Familiarity with the RT-11 system, as described in the 
RT-11 System User's Guide, is particularly helpful when you perform the 
procedures in this manual. 

If you are a FORTRAN IV, BASIC-11, FMS-11, CTS-300, or other layered 
product user, you build your FORTRAN IV, BASIC-11, FMS-11, or other 
system after building the RT-11 system. A layered product is software that 
is sold separately but requires the RT-11 operating system environment to 
run. See the appropriate installation manual for instructions on installing 
such products. 
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Documentation Conventions 

You should become familiar with certain symbolic conventions used in this 
manual. 

1. Examples consist of actual computer output whenever possible. In these 
examples, user input appears in red where it must be differentiated 
from computer output. 

2. Unless the manual indicates otherwise, all commands or command 
strings end with a carriage return. The symbol (EH) represents a car- 
riage return, © a line feed, HE) a space, (He) an ESCAPE or ALTMODE, 
and (H a tab. 

3. To produce certain characters in system commands, you must type a 
combination of keys concurrently. For example, while holding down the 
CTRL key, type C to produce the CTRL/C character. Key combinations 
such as this are documented as (ctrl/c] , (ctrl/o) , and so forth. 

4. In descriptions of command syntax, capital letters represent the com- 
mand name, which you must type. Lowercase letters represent a varia- 
ble for which you must supply a value. 

5. In examples, you must distinguish between the capital letter O and the 
number 0. Examples in this manual represent these characters as fol- 
lows: 

Letter O: 

) 
Number 0: 

6. The sample terminal dialog in this manual contains version numbers 
where they would normally appear. The version numbers include xx in 
those fields that can vary from installation to installation. The exact 
contents of these fields are not of interest in the examples in this man- 
ual, as long as appropriate digits appear in the area indicated. The 
same is true for the FREE BLOCKS messages included in device direc- 
tories. \ 

If you submit a software performance report (SPR) to DIGITAL, you 
must include the complete version number. 

7. A decimal point (.) follows a number to ; indicate that it is a decimal 
number. A number without a decimal point is an octal number. For 
example, 128. is 128 (decimal) and 126 is 126 (octal). 
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Chapter 1 
Introduction 



Now that your PDP-11 processor or Professional 300 series computer has 
been installed and your software distribution kit has been delivered, you 
are ready to get started with RT-11. To begin, you must install RT-11. 
Installation requires bootstrapping and preserving the distribution vol- 
umes, installing software updates if necessary, creating the working sys- 
tem from selected components, and customizing, preserving, and testing the 
working system. In most cases, your system is ready to run once you have 
installed and tested it. However, if you need certain special features, for 
example, multiterminal support, you must perform the system generation 
process. In this case, you must run the SYSGEN program, answer its ques- 
tions, and assemble your own generated monitor(s) and device handlers. 
Figure 1-1 summarizes the flow of the installation process. Refer to the 
RT-11 System Generation Guide for specific information about generating 
specialized monitors. 

The following sections will help you decide which course of action you 
should take. Once you have established which steps you must complete, 
identify the chapters you need to read. You need not read this entire 
manual. 



1.1 Identifying Your Needs 



In order to select the procedures you must perform and the reading path 
you should follow, answer the following questions, using the information in 
Sections 1.1.1 through 1.1.3. 

• What is your hardware configuration? 

• Which monitor(s) do you need? 

• Which features do you need? 
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Figure 1—1: RT-11 Installation Process 
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CREATE PLANNED 
WORKING SYSTEM BY 

COPYING CHOSEN 
FILES TO VOLUME(S) 




COPY 

BOOTSTRAP TO 

VOLUME(S) TO BE 

BOOTABLE 



INSTALL SPECIAL 

PATCHES OR EDIT 

START-UP COMMAND 

FILE 



COMPRESS FREE 

SPACE ON EACH 

WORKING SYSTEM 

VOLUME 



FORMAT WORKING 

SYSTEM BACKUP 

VOLUME(S) IF 

APPROPRIATE 



INITIALIZE 

WORKING 

SYSTEM 

BACKUP VOLUME(S) 



STORE UPDATED 

BACKUP VOLUME(S) 

FOR FUTURE 

UPDATING 



BOOTSTRAP 
WORKING 
SYSTEM 



COPY WORKING 
SYSTEM TO 

BACKUP 
VOLUME(S) 



STORE BACKUP 
VOLUMES 



TEST WORKING 

SYSTEM 
(DO EXERCISES) 




DIGITAL 

CONSIDERS 

RT-11 INSTALLED 




REFER TO RT-11 

SYSTEM GENERATION j 

GUIDE 



( END ) 



1-2 Introduction 



1.1.1 What Is Your Hardware Configuration? 

Your hardware configuration is an important consideration for three rea- 
sons: 

1. Installation procedures vary according to the hardware configuration. 

2. System generation cannot be performed on all hardware configurations. 

3. System generation procedures vary according to the hardware configu- 
ration. 

Chapters 3 through 11 contain detailed procedures for installing RT-11 
systems on certain common hardware configurations. Unless you have an 
unusual configuration, read only the chapter intended for your configura- 
tion. (See Table 1-5 to identify your reading path.) 

1.1.2 Which Monitor(s) Do You Need? 

You have to decide which monitor or monitors you need in order to know 
what steps to follow in getting started. Your distribution kit includes a 
base-line single-job monitor (BL), a single-job monitor (SJ), a 
foreground/background monitor (FB), and an extended memory monitor 
(XM). Sections 1.1.2.1 through 1.1.2.4 describe the various monitors, and 
Table 1-1 summarizes the features available in the distributed monitors. 
The sections and the table give you the information you need to make a 
decision about your monitor requirements. 

Table 1-1: Features Available in Distributed Monitors 







Monitor 




Characteristics 


BL 


SJ 


FB 


XM 


Memory limits 


16Kto 
30K words 


16K to 
30K words 


24Kto 
30K words 


32Kto 
124K words 
(up to 2M words 
in Q-bus systems) 


Size of resident 
monitor 


1.8K words 


2.0K words 


5.3K words 


6.6K words plus 
2.6K words for USR 


Size of disk 
image 


71 blocks 
(approx.) 


73 blocks 
(approx.) 


86 blocks 
(approx.) 


95 blocks 
(approx.) 


FG job support 


no 


no 


yes 


yes 


System job support 


no 


no 


no* 


yes* 


Timer support (.MRKT 
and .CMKT — including 
midnight date/time 
rollover) 


no 


no* 


yes 


yes 


Error messages on 
system I/O errors 


no* 


yes* 


yes 


yes 



Feature enabled/disabled by system generation. 
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Table 1-1: Features Available in Distributed Monitors (Cont.) 



Monitor 



Characteristics 



BL 



SJ 



FB 



XM 



Multiterminal support no 

60Hz clock frequency yes* 

50Hz clock frequency no* 
instead of 60Hz 



no* 

yes* 

no* 



no 



* 



yes 
no* 



* 



no* 



yes* 



no* 



Programmable clock 
instead of line 
as system clock 


no 


no* 


no* 


no* 


Start-up command file 


yes* 


yes* 


yes* 


yes* 


Memory parity support 


no 


no* 


no* 


yes* 


Month and year date 
rollover support 


no 


no* 


no* 


no* 


Fetchable device 
handlers 


yes 


yes 


yes 


yes* 


User command 
linkage support 


no 


yes* 


yes* 


yes* 


Concise command 
language 


yes 


yes 


yes 


yes 


High-speed ring buffer 


no 


no* 


no* 


no* 


Contains all 
keyboard monitor 
commands 


yes* 


yes* 


yes* 


yes* 


Floating point support 


no 


yes* 


yes* 


yes* 


Error message 
on power fail 


no 


no* 


no* 


no* 


BATCH 


no 


no* 


no* 


no* 


Error logging 


no 


no* 


no* 


no* 


MSCP devices 


yest 


yest 


yest 


yest 


RD50/RD51 


no 


no 


yest 


yest 


RK11/RK05 


yest 


yest 


yest 


yest 


RL01/RL02 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


RJS03/RJS04 


yest 
(RJS03) 


yest 
(RJS03) 


yest 
(RJS03) 


not 
(RJS03) 


RK06/RK07 


yest 


yest 


yest 


yest 


RF11 


yest 


yest 


yest 


not 


RP11/RPR02/RP03 


yest 


yest 


yest 


not 



* Feature enabled/disabled by system generation. 

t Refer to Section 2.7.11. 

t RT-11 no longer supports this device; however, the handler 



(continued on next page) 
is included in the software kit. 



1-4 Introduction 



Table 1-1: Features Available in Distributed Monitors (Cont.) 







Monitor 






Characteristics 


BL 


SJ 


FB 


XM 


RX01 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


RX02 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


yest 

(2 drives) 


RX50 


no 


no 


yest 


yest 


DECtape 


yest 


yest 


yest 


not 


DECtape II 


yest 


yest 


yest 


yest 


PDT-11 intelligent 
terminal 


yes+ 


yest 


yest 


no 


Virtual memory 
handler 


yes 


yes 


yes 


yes 

(as data 
device only) 


File-structured 
magtape — TM11 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


File-structured 
magtape — TJU16 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


File-structured 
magtape — TS11 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


yes 

(2 units) 


Hardware magtape TM11 


no§ 


no§ 


no§ 


no§ 


Hardware magtape TJU16 


no§ 


no§ 


no§ 


no§ 


Hardware magtape TS11 


no§ 


no§ 


no§ 


no§ 


TA11 cassette 


yest 


yest 


yest 


no 


VT11/VS60 


no 


no* 


no* 


no 


Line printer 


yes 


yes 


yes 


yes 


Serial printer 


yes 


yes 


yes 


yes 


High-speed paper tape 
reader/punch 


yest 


yest 


yest 


not 


CR11 card reader 


yest 


yest 


yest 


no 


Null handler 


yes 


yes 


yes 


yes 


Logical disk handler 


yes 


yes 


yes 


yes 


Single-line editor 


yes 


yes 


yes 


yes 


Extra device slots 


0* 


0* 


0* 


4* 



* Feature enabled/disabled by system generation. 

t Eefer to Section 2.7.11. 

t RT-11 no longer supports this device; however, the handler is included in the software kit 

§ Refer to Section 2.7.11.2. 
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1.1.2.1 Base-Line Single-Job Monitor — The base-line single-job monitor 
(BL) is a stripped-down version of the single-job monitor (SJ). The BL moni- 
tor does not support optional monitor and device functions. It has the small- 
est residency requirement of any RT-11 monitor and is intended for use in 
applications that require small monitor size and minimal executive sup- 
port. 

Table 1-2 summarizes the differences between the distributed BL and SJ 
monitors. 

Table 1-2: Base-Line Monitor Versus Single-Job Monitor 



BL Monitor S J Monitor 

Does not support graphic display. Supports graphic display terminal 

(VT11/VS60) as ASCII console termi- 
nal. 

System halts on power failure or sys- System prints error message on power 

tem device I/O error. failure or system device I/O error. . 

Supports only one terminal. Can be generated to support more than 

one terminal. 

Minimal memory and system device Requires slightly larger memory and 
requirements for monitor. system device for monitor. 

Does not include floating point sup- Includes floating point support, 

port. 

If your application program is very large and you require the smallest 
possible monitor, the BL monitor may be your best choice. The BL monitor 
can perform all the system commands and can run most of the utilities. For 
highly interactive applications, you should use the SJ monitor. The more 
complete error processing and device support available in the SJ monitor 
provide a base that is easier to use and more flexible. 

1.1.2.2 Single-Job Monitor — Of all the distributed RT-11 monitors, the 
single-job monitor (SJ) has the fastest response times at interrupt and key- 
board levels and the lowest memory requirements, except for the BL moni- 
tor. If your application involves interactive program development, maxi- 
mum-throughput real-time data acquisition, or continuous execution of a 
single end-user application program, the SJ monitor is the best choice. 

The SJ monitor supports all hardware devices (except memory manage- 
ment hardware) and runs all the system utilities except QUEUE or 
SPOOL. It runs in any supported configuration, except Professional 300 
series processors, with at least 16K words of memory .but cannot make use 
of more than 28K words of memory (30K on an LSI-11 processor). 

1.1.2.3 Foreground/Background Monitor — The foreground/background mon- 
itor (FB) is the smallest RT-11 monitor that supports multiprogramming. 
It allows you to execute a completely independent foreground job at a 
higher software priority level than the background, while you use the re- 
maining system facilities to support the background. The RT-11 fore- 
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ground job is not intended for a two-user time-sharing system. Rather, it 
best supports a stable, event-driven real-time or I/O application that can 
execute with a minimum of user interaction while the bulk of the system's 
business is conducted in the background. 

The background in the foreground/background environment appears just 
like the SJ monitor; all the facilities available to you as an SJ user are 
available to you as an FB user in the background. 

The FB monitor provides you with more features than the SJ monitor. 
These include: 

1. The ability to run a foreground job 

2. Enhanced terminal service 

3. Extended executive facilities for real-time applications 

The minimum memory requirement for the FB monitor is 24K words. The 
FB monitor resides in 8K or fewer words of memory and cannot use more 
than 28K words of memory (30K on an LSI-11 processor). 

If your application includes the need for a software priority real-time appli- 
cation to run concurrently with normal system development and data-pro- 
cessing applications, the FB monitor is the suitable choice. If you do not 
require concurrent real-time execution, you can conserve system resources 
by using the SJ monitor. 

1.1.2.4 Extended Memory Monitor — The extended memory monitor (XM) is 
the largest and most powerful of the RT-11 executives. It has all the facili- 
ties of the FB monitor; in addition, it can support up to 128K words of 
memory in systems supporting 18-bit architecture and up to 2 megawords 
of memory in Q-bus systems supporting 22-bit architecture. The XM moni- 
tor provides a set of programmed requests that allow advanced applications 
to make use of additional memory above 28K (using the PDP-11 memory 
management unit). 

The XM monitor is significantly larger than the FB monitor. The XM moni- 
tor's requirement that the USR be resident adds even more to the monitor 
memory overhead. Consequently, if you have no more than 48K words of 
memory, choose one of the other monitors. Also, if your application involves 
program development or execution of an end-user application that does not 
make use of extended memory facilities, you may opt for the FB or SJ 
monitor. 

The XM monitor requires 32K words of memory, a memory management 
unit (KT11 hardware), and the extended instruction set (EIS) option to 
operate. 

1.1.3 Which Features Do You Need? 

The following sections summarize the available RT-11 features, so that you 
can decide which features you need and determine how to obtain them. You 
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can secure some of the features through simple software customization pro- 
cedures during a standard installation process. However, other features are 
available only when you go through the system generation process. 

1.1.3.1 Is Installation All You Need to Do? — You need to decide whether 
installation is all you need to do or whether you will also need to perform 
the system generation process. Table 1-3 summarizes the features that you 
can add to your system by performing simple customizations during instal- 
lation. Section 2.7 describes these software customizations in detail and 
provides instructions for implementing them. Many users will not need to 
make any of these customizations. 

Table 1-3: Features Available Through Simple Software Custom- 
izations 



Feature 



Section 



Procedure 



Adding 
subroutines 
to SYSLIB.OBJ 



Changing 
characters 
SRCCOM uses 
to indicate 
insertions and 
deletions 

Changing 
default 
output device 
from line 
printer to 
terminal 

Changing 
location of 
VT11/VS60 
floating vectors 

Changing 
number of 
directory 
columns 



Changing 
default order 
of directory 
listings 



2.3.5 To add subroutines to the default system library, 
SYSLIB.OBJ, use the librarian. The RT-11 linker 
searches SYSLIB to resolve undefined globals at 
the end of a link operation. Normally, you should 
customize SYSLIB to contain the system sub- 
routines, FORTRAN OTS routines, and applica- 
tion-specific subroutines. 

2.7.1 Normally, when you use the SRCCOM utility or 
DIFFERENCES/CHANGEBAR command to com- 
pare two files, SRCCOM uses the vertical bar 
character to indicate insertions and the bullet (al- 
phabetic o) character to indicate deletions. You 
can modify SRCCOM to use different characters. 

2.7.2 If your configuration does not include a line 
printer, you can change the default output device 
(which certain monitor commands use) from line 
printer to terminal. To make this change, you can 
edit the start-up command file. 

2.7.3 If you add certain other devices to a configuration 
that includes a VT11 or VS60, you must modify 
the monitor to move the VT11 or VS60 vector ad- 
dresses. 

2.7.4 When you use the DIRECTORY command, the di- 
rectory prints in two columns. When you use the 
DIRECTORY/BRIEF command, the directory con- 
tains five columns with less information. You can 
modify DIR to change the default number of col- 
umns. 

2.7.5 By default, DIR lists a directory's contents by 
physical position. You can modify DIR to change 
the default to any one of five orders: creation date, 
file name, file size, file type, or position. 



(continued on next page) 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Changing 
number of /Q 
p-sects LINK 
allows 

Changing 
size of LINK'S 
library module 

list 

Changing 

size of 

QUEUE work file 

Modifying 
EDIT 



Extracting 

overlay 

handlers 

from 

SYSLIB.OBJ 

Installing 

other 

devices 



2.7.6 You can modify LINK to change the number of 
absolute base-address p-sects that LINK allows. 
Normally, LINK'S /Q option lets you specify the 
absolute base addresses of up to eight p-sects in 
your program. 

2.7.7 To change the default size of LINK's list of library 
modules, you can modify LINK. LINK normally 
creates a list of 252 (octal) modules to be included 
from libraries during the link operation. If you are 
a DIBOL user, you must customize the software. 

2.7.8 You can modify QUEUE to change the size of the 
work file QUEUE uses to queue files to be sent to 
a device. If you increase the size of the work file, 
QUEUE can handle more files at one time. 

2.7.9 In certain applications using VT11/VS60 termi- 
nals, the text window overflows onto the scrolled 
editing commands, making a portion of the screen 
difficult to read. You can alleviate this problem by 
changing EDIT to reduce the size of the text win- 
dow. 

If you have a terminal with nonstandard ESCAPE 
code (that is, the terminal generates 175 octal or 
176 octal rather than 33 octal), you must modify 
EDIT so that it operates correctly. 

2.7.10 If you intend to use overlaid programs, you need 
the overlay handlers that are included in SYSLIB. 
If you are a MACRO-only user and need only the 
overlay handlers, you can extract them from SYS- 
LIB for use as a separate library. 

2.7.11 When you boot the system device, the bootstrap 
installs the devices in your hardware configura- 
tion if the appropriate device handler is on the 
system device and if there are enough device slots. 
If you want to install a device that the bootstrap 
does not install, use the REMOVE and INSTALL 
commands. You can also: 

Change LP, LS, DD, RK, DX, DY, DL, DM, or DU 
addresses: If any of these devices are installed at 
nonstandard CSR and vector addresses, you can 
use the monitor SET command to change the ad- 
dresses. 

Install hardware magtape: If you need hardware 
magtape support, you must perform a system gen- 
eration and then rename the hardware handler to 
MT.SYS, MM.SYS, or MS.SYS. 

(continued on next page) 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Installing 
other 
devices (cont.) 



Modifying 
BATCH 
to save 
space 



Modifying 
LINK to change 
default SYSLIB 
device 

Modifying 
help text 



Preventing 
fatal system 
errors from 
causing a 
reset 



Running RT-11 
in less 

memory than 
is available 

Setting VTCOM 
default dial 
string 

Setting 
upper limit 
on file size 

Specifying 
50-cycle clock 
rate 



Set magtape parity and density: If you need to set 
magtape parity or density (other than the stand- 
ard 800 bits/in, odd parity), you can use the moni- 
tor SET command for TM11 or TJU16 magtape 
(but not TS11). 

Change RP02 support to RP03: To use RP03 disk 
drives, you must think of each RP03 drive as two 
logical units of 40,000 blocks. 

2.7.12 If you need to save disk space, you can store cer- 
tain system programs on DK: rather than on SY: 
and cause BATCH to access them there. Modify 
BATCH so that it invokes system programs with. 
the monitor RUN command (which assumes DK: 
as the default) rather than with the R command 
(which always uses SY:). 

2.7.13 By customizing the linker, you can change the de- 
vice on which the default system library, SYS- 
LIB. OBJ, resides. 

2.7.14 To change the help text that prints when you use 
the HELP command, you must create your own 
help text file, process that text file with LIBR, and 
copy the resulting library and the file HELP.EXE 
to the same volume. 

2.7.15 You can customize the monitor to prevent it from 
performing a hard reset of errors when a fatal sys- 
tem error occurs. The normal reset stops I/O, pro- 
tecting media from being corrupted. Some hard- 
ware errors may be more easily diagnosed without 
this reset. 

2.7.16 You can customize your software if your applica- 
tion requires that RT-11 run in less memory than 
is available. 



2.7.17 You can modify VTCOM to set a default string for 
the DIAL command. 



2.7.18 If your application requires an upper limit to the 
size of a file, you can change the monitor to set the 
limit you require. 

2.7.19 To use a 50-cycle clock rate rather than the 60- 
cycle clock of the standard monitors, you must 
modify the monitor. 



(continued on next page) 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Using CAPS-11 2.7.20 

to load files 

Setting upper 2.7.21 

limit on 
memory size 

Suppressing 2.7.22 

bootstrap 

message 

Suppressing 2.7.23 

start-up 

indirect 

command file 

Suppressing 2.7.24 

start-up 

indirect 

command 

file echo 

Changing 2.7.25 

bootstrap 

message 

Changing 2.7.26 

default device 
for indirect 
command files 

Changing 2.7.27 

default file 

type for 

indirect 

command files 

Changing 2.7.28 

default device 
for FRUN 
command 

Changing 2.7.29 

default file 
type for FRUN 
command 

Changing 2.7.30 

default device 
for EDIT 
command 



If you need to use CAPS-11 to load RT-11 files, 
you must modify the cassette handler, CT.SYS, to 
alter header records. 

If your PDP-11 does not generate a bus timeout 
trap, RT-11 does not load into memory properly. 
You can alter the monitor to cause the bootstrap to 
never look for more than 28K words of memory. 

If you want to prevent the monitor identification 
message from printing when you bootstrap a mon- 
itor, you can modify that monitor. 

If you want to prevent the start-up command file 
from executing when you bootstrap a monitor, you 
can modify that monitor. 

If you want the start-up indirect command file to 
execute when you bootstrap a monitor but you do 
not want the command lines in the file to echo 
(appear) on the terminal, you can modify the mon- 
itor. 

If you want to change the monitor identification 
message that appears when you bootstrap a moni- 
tor, you can modify that monitor. 

If you want to change the default device for indi- 
rect command files, you can modify the monitor. 
Normally, the monitor looks for the command file 
on DK:. 

If you want to change the default file type for indi- 
rect command files, you can modify the monitor. 
Normally, indirect command files have the default 
file type .COM. 

If you want to change the default device for the 
FRUN command, you can modify the 
monitor. Normally, the monitor looks for the 
foreground program on device DK: when you type 
FRUN filnam. 

If you want to change the default file type for the 
FRUN command, you can modify the monitor. 
Normally, the default file type for foreground pro- 
grams is .REL. 

If you want to change the default device for the 
EDIT command, you can modify the monitor. Nor- 
mally, the monitor looks for EDIT.SAV on device 
SY:. 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Changing 2.7.31 

default file 
name for 
EDIT command 

Using Examine 2.7.32 

and Deposit 
above 
background job 



Changing 2.7.33 

default 

device for 

QUEMAN 



Changing 2.7.34 

indirect 
command file 
nesting depth 

Changing 2.7.35 

threshold for 

resuming 

output-stalled 

jobs 

Changing 2.7.36 

default number 
of directory 
segments 

Changing 2.7.37 

width of 

banner pages 

from 132 

to 80 columns 

Modifying 2.7.38 

listing page 
length in 
LINK 

Assigning 2.7.39 

help file 



If you want the monitor to run an editor other 
than the default editor when you type the EDIT 
command, you can modify the monitor to change 
the file name of the default editor. 

If you want to be able to examine and modify the 
monitor and the I/O page, you can customize the 
monitor to remove a restriction on the use of the 
examine (E) and deposit (D) commands. Normally, 
the monitor allows you to examine and modify 
only locations inside the background job's area. 

If you want to send a file to a device other than 
LP: when you use the PRINT command in an FB 
system (with QUEUE running as a foreground 
job), you can modify the monitor to change the de- 
fault. This modification also changes the default 
for the DELETE/ENTRY command. 

If you want to change the depth to which you can 
nest indirect command files, you can modify the 
monitor. Normally, RT-11 allows you to nest indi- 
rect command files three deep. 

If you have a foreground job that produces much 
terminal output and stalls frequently (waiting for 
room in the terminal output buffer), you can mod- 
ify the monitor to improve throughput. 

If you want DUP to use a different default number 
of directory segments when you initialize volumes, 
you can modify DUP. DUP normally uses the 
number of directory segments specified in a table 
in DUP. 

If you want to change the width of banner page 
printouts from 132 to 80 columns, you can modify 
QUEUE. 



If your line printer uses paper that is not 10.5 
inches long, or if you do not have a line printer, 
you can modify LINK to change the listing page 
length from the standard 60 lines. 

You can modify the monitor to assign your HELP 
file to a file or device other than SY:HELP.SAV. 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Changing 
device from 
which IND 
is run 

Replacing 
bad blocks 



Including 
user-written 
magtape handler 

Producing 
1600 bits/in 
bootable magtape 

Changing 
default file 
type of logical 
disk files 

Changing 
QUEUE to 
allow first 
form feed 

Changing 
listing page 
length in 
MACRO and 
CREF 

Changing 
default command 
file processor 
to IND 

Limiting 
amount of 
memory KEX 
requests 

Changing 
MACRO'S default 
.LIST/.NLIST 
options 



2.7.40 You can modify the monitor to change the device 
from which IND is run. 



2.7.41 You must customize DUP if your user-written de- 
vice handler supports bad block replacement. One 
change is required to replace all bad blocks, an- 
other to replace only bad sectors. 

2.7.42 You must customize DUP, PIP, and MDUP if you 
use a user-written magtape handler. 



2.7.43 



2.7.44 



2.7.45 



2.7.46 



You can edit DISMT1.COM to replace module 
MBOOT.BOT with MBOT16.BOT, a primary boot- 
strap for producing 1600 bits/in, phase-encoded 
bootable magtape. 

You can change the default file type of logical disk 
files from .DSK by modifying either the LD.SYS 
file or the conditional file SYSGEN.CND. 

You can modify QUEUE to never suppress the ini- 
tial form feed in a file. 



You can change the default (60 lines) page listing 
length for MACRO and CREF. 



2.7.47 You can change the monitor command file proces- 
sor from KMON to IND. 



2.7.48 You can reduce memory requested by KEX from 
the default 32KW to your requirements by using 
the .SETTOP programmed request. 

2.7.49 You can change the default options for the 
.LIST/.NLIST macros. 
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Table 1-3: Features Available Through Simple Software Custom- 
izations (Cont.) 



Feature 



Section 



Procedure 



Changing 

MACRO'S default 

.ENABLE/.DIS- 

ABLE 

options 

Modifying 
KED default 
file type 

Changing 
SPOOL'S work 
file size 

Changing 
SPOOL'S output 
device 

Changing 
LINK'S default 
map and table 
output to 
132 columns 



2.7.50 You can change the default options for the 
.ENABLE/.DISABLE macros. 



2.7.51 You can change the KED default file type. 



2.7.52 You can change the size of SPOOL'S work file. 



2.7.53 You can change SPOOL'S default output device. 



2.7.54 You can change LINK'S default link map and 
global cross-reference table output to 132 columns. 



1.1.3.2 Do You Need to Perform the System Generation Procedures? — You 

must perform the system generation procedures if you want to add to your 
system any features listed in Table 1—^. You may also need to perform the 
system generation procedures if you want to remove features to reduce the 
size of the monitor and improve response time. Refer to the system genera- 
tion dialog and the descriptive text in the RT-11 System Generation Guide 
for further information about these features. 

You should not attempt to perform the system generation procedures un- 
less your hardware configuration meets certain requirements. DIGITAL 
supports automatic system generation (under license) only on a system 
with at least 16K words of memory and 2000 free blocks of disk storage. 
The minimum configuration that DIGITAL recommends for system genera- 
tion is a system with at least two disk drives and 24K words of memory. 
DIGITAL also supports system generation on dual-diskette systems (with 
at least 28K words of memory) if you use the manual method described in 
the RT-11 System Generation Guide. However, DIGITAL does not recom- 
mend this very lengthy procedure. 
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Table 1-4: Features Available Only Through the System Genera- 
tion Procedures 



Feature 



Function 



Asynchronous 

terminal 

status 

BATCH 

support 

Device I/O 
timeout 

Disable .FETCH 
request under 
XM 

Double- 
density 
only RX02 

DZ11 up to 
9600 baud 

Error 
logging 



Extra 
device 
slots 

Global 

SCCA 



Graphics 

support 

High-speed 
ring buffer 



Keyboard 
monitor 
command 
subsets 

Memory parity 



Provides a program with the updated status of terminals in 
multiterminal systems. MU BASIC-11 requires this support. 

Job control language allows RT-11 to operate unattended. All 
monitors except BL support BATCH. 

Permits device handlers to issue a mark-time programmed 
request. DECnet applications require this support, but RT-11 
does not. 

Disables the use of the .FETCH request under XM, requiring 
device handlers to be resident in memory. 

Permits you to use only double-density RX02 diskettes on the 
system. This feature makes the RX02 handler smaller. 

Permits you to initialize lines at specific baud rates up to 
9600. 

Keeps a statistical record of device, memory parity, and mem- 
ory cache errors. An error logging job is created when you 
select this support. The EL job retrieves information that is 
later available to you in summary report format. All monitors 
except BL support error logging. 

Permits you to add devices to the system after it is built. The 
number of logical assignments you can make is equal to the 
number of devices plus the empty device slots in the system. 

When global SCCA is turned on (enabled), all CTRL/C charac- 
ters sent from the terminal to the background are ignored, 
protecting the program from being aborted with double 
CTRL/Cs. Support must be chosen to use IND directives .EN- 
ABLE ABORT and .DISABLE ABORT. 

Enables the commands GT ON and GT OFF. 

Causes character processing and interpretation to be per- 
formed at the fork level, allowing short bursts of characters 
transmitted at very high rates to be received. Use of this fea- 
ture is recommended with PDTs. All monitors except BL 
support this feature. 

Allows you to choose one, two, or three subsets of the keyboard 
monitor commands instead of all the commands. 



Causes the system to print an error message when a memory 
parity error occurs if your configuration includes memory par- 
ity hardware. If you have this hardware but do not select this 
support, the system halts when memory errors occur. All mon- 
itors except BL support this feature; it is available in the dis- 
tributed XM monitor. 

(continued on next page) 
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Table 1-4: Features Available Only Through the System Genera- 
tion Procedures (Cont.) 



Feature 



Month and year 
rollover 



Multiterminal 
support 

Multiterminal 
timeout 



Programmable 
clock as 
system clock 

Ring buffer 
size 



Second RX01, 
RX02, or 
TU58 
controller 

SJ message 
on system 
I/O errors 

SJ timer 



.SPCPS 

programmed 

request 



Function 



Adds support that automatically rolls over the date at the end 
of the month and the end of the year. Normally, you must 
reset the date and time. This support is useful for applications 
that run continuously and over a long period of time. All 
monitors except BL support this feature. 

Permits you to use two or more terminals with the SJ, FB, or 
XM monitor. MU BASIC-11 requires this support. 

Causes the monitor to reset at regular intervals any terminal 
that goes offline. This support minimizes the impact of static 
in multiterminal systems. MU BASIC-11 requires this sup- 
port. 

Allows you to substitute as the system clock the KW11-P pro- 
grammable clock for the usual line clock. However, the pro- 
grammable clock would not then be available for program use. 
All monitors except BL support this feature. 

Allows you to change the size of the input and output ring 
buffers. The input ring is a buffer in the monitor that holds 
characters you type at a terminal until a program requests 
them. The output ring is a buffer in the monitor that holds 
characters until the terminal can print them. The default in- 
put ring buffer size is 134 (decimal) characters, and the de- 
fault output ring buffer size is 40 (decimal) characters. 

Adds support for a second RX01, RX02, or TU58 controller, 
allowing a total of four units in the configuration instead of 
the usual two. 



Causes the SJ monitor to issue an error message instead of 
simply halting. This feature helps to reduce confusion when 
an error occurs. The FB and XM monitors always issue error 
messages. 

Configures the SJ monitor to support mark-time and cancel 
mark-time programmed requests. Otherwise, only the FB and 
XM monitors support these requests, which provide timer ca- 
pabilities. 

The save/set main-line PC and PS (.SPCPS) programmed re- 
quest changes the flow of control of main-line code by saving 
the PC and PS and changing the main-line PC to a new value. 
This support can be generated for only the FB and XM 
monitors. .SPCPS is especially useful to control the switch- 
ing context among users in multiuser applications. 

(continued on next page) 
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Table 1-4: Features Available Only Through the System Genera- 
tion Procedures (Cont.) 



Feature Function 



System Assembles the FB or XM monitor to support as many as eight 

jobs simultaneously active jobs instead of the usual two. The error 

logging subsystem, the device queue program (QUEUE), the 
transparent spooler (SPOOL), and the communication pack- 
age (VTCOM) can run as system jobs. This feature is available 
in the distributed XM monitor. 

User command Permits users to create their own commands in a format simi- 

linkage lar to supplied DCL commands. All monitors except BL sup- 

port this feature. 



1.2 Choosing a Reading Path 

s 

The modular organization of this manual limits your reading to those chap- 
ters that answer your needs. Table 1-5 gives you the information you need 
to select these chapters. To use the table, find your distribution medium 
and your target system device (the device that you will want to bootstrap 
and that will contain the monitors and system components). Then find in 
the rightmost column the relevant chapters for your configuration. If you 
must perform a system generation, refer to the RT-11 System Generation 
Guide after you have installed your system. 

Also skim the table of contents of this manual for an overview of the addi- 
tional information offered in the appendixes. 

NOTE 

If you are unfamiliar with RT-11 software, you should proba- 
bly use the distributed monitors uncustomized for a while. 
Once you have gained familiarity with the system, you will 
\ be better equipped to perform customizations or system gen- 

eration procedures. Be aware, however, that some customiza- 
tions may be essential for your particular application, and, 
consequently, you may experience problems when you use 
software without needed support. If you are an inexperienced 
user, be sure to study Tables 1-3 and 1-4, but you may want 
to skip Section 2.7 (Software Customizations) until you have 
gained some experience. 



.; 
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Table 1-5: Chapters You Should Read 





System Device 


; 


Distribution 


in 




Medium 


Target System 


Chapters 


Single-Density 


Single-Density 


1,2,3 


Diskette 


Diskette 




RX01 


or DECtapell 






Hard Disk 


1,2,4 




RL01 






RL02 






RK05 






RK06 






RK07 




Hard Disk 


Hard Disk 


1,2,5 


RL01 


RL01 




RL02 


RL02 




RK05 


RK05 




RC25 


RK06 
RK07 
RC25 






Single-Density or 


1,2,6 




Double-Density 






Diskette 




Double-Density 


Double-Density 


1, 2, 7 j 


Diskette 


Diskette 




RX02 


RX02 




Magtape 


Hard Disk 


1,2,8 


TM11 


RL01 




TJU16 


RL02 
RK05 
RK06 
RK07 


^ 


Diskette RX50 


RD51 (MICRO/PDP-11) 


1, 2, 9 ' 




RD51 (Professional 350) 


1, 2, 11 




Diskette 






RX50 


1, 2, 10 
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Chapter 2 

Preparing for Installation 



) You should take certain steps, summarized in the following list, before you 

actually begin to install your system. 

1. Survey the general installation procedures. 

2. Study the contents of your software kit. 

3. Select the components you need in your working system. 

4. Plan the arrangement of components. 
,' 5. Install any software updates. 

6. Acquire sufficient media. 

7. Choose the software customizations you need to make. 

You can use the worksheet (Figure 2-2) at the end of this chapter to record 
the components you select, the arrangement of files you plan, and any other 

information you need in order to perform the installation procedures. 

\ 

i 

; 

2.1 Surveying Installation Procedures 

Although the specific steps you must perform to install RT-11 depend on 
your configuration, all users must perform some general procedures. 

First, you must bootstrap the distribution volume and preserve the volume 
(or volumes) by making backup copies. Then you must install software 
updates if any have been published, in all affected components. You then 
create the working system from chosen components (eliminating compo- 
nents you do not need) and install the bootstrap on the working system 
volume(s). At this point, you make software customizations, which do not 
require performing the system generation process. When you have custom- 
ized the system, you should compress the working system volume or vol- 
umes and preserve them on backup volumes. Once you are satisfied with 
the working system you have created, you should test it to make sure that 
j it works properly. 
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2.2 Studying Software Kit Contents 

Familiarity with the contents of the software kit you received helps to 
make the installation procedures go smoothly. You should learn which files 
are included in the kit and what each file does. 

Study Table 2-1 for a summary of the RT-11 components distributed in the 
kits, and refer to the RT-11 System Utilities Manual for a thorough de- 
scription of each utility. RT-11 is distributed on RC25, RL01, RL02, and 
RK05 disks, on RX01, RX02, and RX50 diskettes, and on magtape. The 
organization of files on volumes depends on the distribution medium. 

Table 2-1: RT-11 Software Components 



Type of 
Software 



Description 



Monitors 

RT11AI.SYS 
RT11BL.SYS 
RT11SJ.SYS 
RT11FB.SYS 
RT11XM.SYS 
RT11PI.SYS 
Device Handlers 
CR.SYS 
CT.SYS 
DD.SYS 
DDX.SYS 
DL.SYS 
DLX.SYS 
DM.SYS 
DMX.SYS 
DP.SYS 
DS.SYS 
DT.SYS 
DU.SYS 
DUX.SYS 
DW.SYS 
DWX.SYS 
DX.SYS 



Automatic installation monitor 

Base-line single-job monitor 

Single-job monitor 

Foreground/Background monitor 

Extended memory monitor 

Automatic installation monitor for Professional 300 series 

Card reader handler for SJ, FB monitors 

TA11 cassette handler for SJ, FB monitors 

DECtape II handler for SJ, FB monitors 

DECtape II handler for XM monitor 

RL11/RL01/RL02 handler for SJ, FB monitors 

RL11/RL01/RL02 handler for XM monitor 

RK611/RK06/RK07 handler for SJ, FB monitors 

RK611/RK06/RK07 handler for XM monitor 

RP11/RP02/RP03 handler for SJ, FB monitors 

RJS03/04 handler for SJ, FB monitors 

DECtape handler for SJ, FB monitors 

MSCP device handler for SJ, FB monitors 

MSCP device handler for XM monitor 

Winchester disk handler for FB monitor 

Winchester disk handler for XM monitor 

RX11/RX01 single-density diskette handler for SJ, FB moni- 
tors 



(continued on next page) 
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Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



DXX.SYS RX11/RX01 single-density diskette handler for XM monitor 

DY.SYS RX211/RX02 handler for SJ, FB monitors 

DYX.SYS RX211/RX02 handler for XM monitor 

DZ.SYS Diskette handler for FB monitor 

DZX.SYS Diskette handler for XM monitor 

LD.SYS Logical disk subsetting handler for SJ, FB monitors 

LDX.SYS Logical disk subsetting handler for XM monitor 

LP.SYS Line printer handler for SJ, FB monitors 

LPX.SYS Line printer handler for XM monitor 

LS.SYS Serial printer handler for SJ, FB monitors 

LSX.SYS Serial printer handler for XM monitor 

MM.SYS File-structured TJU16 handler for SJ, FB monitors 

MMX.SYS File-structured TJU16 handler for XM monitor 

MS.SYS File-structured TS11 handler for SJ, FB monitors 

MSX.SYS File-structured TS11 handler for XM monitor 

MT.SYS File-structured TM11 handler for SJ, FB monitors 

MTX.SYS File-structured TM11 handler for XM monitor 

NL.SYS Null handler for SJ, FB monitors 

NLX.SYS Null handler for XM monitor 

PC.SYS High-speed paper tape handler for SJ, FB monitors 

PD.SYS PDT-11 skeleton handler for SJ, FB monitors 

PI.SYS Professional interface handler for video, clock and keyboard 
for FB monitor 

PIX.SYS Professional interface handler for video, clock and keyboard 
for XM monitor 

RF.SYS RF11 handler for SJ, FB monitors 

RK.SYS RK11/RK05 handler for SJ, FB monitors 

RKX.SYS RK11/RK05 handler for XM monitor 

SP.SYS Transparent print spooler handler for FB monitor 

SPX.SYS Transparent print spooler handler for XM monitor 

TT.SYS Terminal handler for SJ monitor 

VM.SYS Virtual disk handler for SJ, FB monitors 

VMX.SYS Virtual disk handler for XM monitor 



(continued on next page) 
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Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



XC.SYS 
XCX.SYS 

XL.SYS 

XLX.SYS 
Other System Files 

SL.SYS 

SLX.SYS 

SWAP.SYS 
Utility Programs 

BINCOM.SAV 

BUP.SAV 

CREF.SAV 

DIR.SAV 

DUMP.SAV 

DUP.SAV 

EDIT.SAV 

FILEX.SAV 

FORMAT.SAV 

HELP.SAV 

IND.SAV 

KED.SAV 

K52.SAV 

LIBR.SAV 

LINK.SAV 

MACRO.SAV 

MDUP.MM 

MDUP.MS 

MDUP.MT 

MDUP.SAV 

PAT.SAV 

PIP.SAV 



Professional communication port modem handler for F'B 
monitor 

Professional communication port modem handler for XM 
monitor 

DL-11 communication port modem handler for FB monitor 

DL-11 communication port modem handler for XM monitor 

Single-line editor pseudohandler for SJ, FB monitors 
Single-line editor pseudohandler for XM monitor 
External monitor swap blocks 

Binary compare utility 

Backup utility 

Cross-reference utility 

Directory utility 

File dump utility 

Disk maintenance utility 

Text editor 

Foreign file exchange utility 

Disk formatting utility 

Help utility 

Indirect control file processor 

Keypad editor for VT100 terminal 

Keypad editor for VT52 terminal 

Librarian 

Linker 

MACRO assembler 

Magtape bootstrap utility for TJU16 

Magtape bootstrap utility for TS11 

Magtape bootstrap utility for TM11 

Magtape utility 

Patching utility for program object modules 

File transfer utility 



(continued on next page) 
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Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



QUEMAN.SAV 

QUEUE.REL 

RESORC.SAV 

SETUP.SAV 

SIPP.SAV 

SLP.SAV 

SPOOL.REL 

SRCCOM.SAV 

SYSMAC.SML 

TRANSF.SAV 

UCL.SAV 

VTCOM.REL 

VTCOM.SAV 

Miscellaneous 

BATCH.SAV 
DISMT1.COM 
DISMT2.COM 
ERROUT.SAV 
RTBL.MAP 
RTSJ.MAP 
RTFB.MAP 
RTXM.MAP 
STARTF.COM 
STARTS.COM 
STARTX.COM 
V5USER.TXT 
System Generation 
SYSGEN.COM 
BL.ANS 
SJFB.ANS 
XM.ANS 



User interface with QUEUE utility 

Device queue utility 

System resource display utility 

VT100 and Professional terminal setup utility 

Save image patch utility 

Source language patch utility 

Transparent print spooler utility 

Source compare utility 

System macro library 

File transfer program for VTCOM, to be installed on RT-11 
or RTEM-11 host system 

User command linkage executable image 

Virtual terminal communication and file transfer utility 

Virtual version of VTCOM communication utility, for run- 
ning under XM monitor 

BATCH processor 

Copy and write bootstrap to distribution magtape 1 

Copy distribution magtape 2 

Error log program 

Distributed BL monitor link map 

Distributed SJ monitor link map 

Distributed FB monitor link map 

Distributed XM monitor link map 

FB start-up command file 

SJ start-up command file 

XM start-up command file 

Distribution kit message text file 

Files 

SYSGEN command file 

Answer file to build distributed BL monitor 

Answer file to build distributed SJ, FB monitors 

Answer file to build distributed XM monitor 



(continued on next page) 



Preparing for Installation 2-5 



Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



Automatic Installation Files 



Automatic installation verification source file 
Start-up file for automatic installation 
Console terminal identification program 
Automatic installation verification command file 



Debugging aid 

Debugging aid for virtual and multiterminal jobs 



IVP.MAC 

STARTA.COM 

TERMID.SAV 

VERIFY.COM 
Debuggers 

ODT.OBJ 

VDT.OBJ 
Graphics Software 

VTHDLR.OBJ VT11/VS60 display handler 

VTMAC.MAC Display handler macro file 

Libraries and Subroutines 

GETSTR.FOR FORTRAN subroutine source 

FORTRAN subroutine source 
System FORTRAN-callable subroutines 



PUTSTR.FOR 
SYSLIB.OBJ 
Bootstraps 
MBOOT.BOT 
MB0T16.B0T 
MSBOOT.BOT 



Magtape primary bootstrap for 8-track tape 
Magtape primary bootstrap for 16-track tape 
Magtape secondary bootstrap 
Demonstration Programs 
DEMOBG.MAC Demonstration source — SJ, FB macro program 
Demonstration source 

Demonstration source — FB macro program 
Demonstration source — FB FORTRAN program 
Demonstration source 



DEMOED.TXT 
DEMOFG.MAC 
DEM0F1.F0R 
DEM0X1.MAC 
Source Files 
BA.MAC 
BSTRAP.MAC 
CR.MAC 
CT.MAC 
DD.MAC 
DL.MAC 
DM.MAC 



BATCH handler source file for system generation 
Bootstrap source file for system generation 
Card reader handler source file for system generation 
Cassette handler source file for system generation 
DECtape II handler source file for system generation 
RL01/02 handler source file for system generation 
RK06/07 handler source file for system generation 



(continued on next page) 
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Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



DP.MAC 

DS.MAC 

DT.MAC 

DU.MAC 

DW.MAC 

DX.MAC 

DY.MAC 

DZ.MAC 

EDTGBL.MAC 

EL.MAC 

ELCOPY.MAC 

ELINIT.MAC 

ELTASK.MAC 

ERROUT.OBJ 

ERRTXT.MAC 

FB.MAC 

FSM.MAC 

KMON.MAC 

KMOVLY.MAC 

LD.MAC 

LP.MAC 
LS.MAC 
MTTEMT.MAC 

MTTINT.MAC 

NL.MAC 
PC.MAC 

PD.MAC 
RF.MAC 
RK.MAC 



RP11 handler source file for system generation 

RJS03/04 handler source file for system generation 

DECtape handler source file for system generation 

MSCP device handler source file for system generation 

Winchester disk handler source file for system generation 

RX01 handler source file for system generation 

RX02 handler source file for system generation 

Diskette handler source file for system generation 

Monitor edit log and global definition file for system genera- 
tion 

Error logger handler source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

Error log job source file for system generation 

FB conditional source file for system generation 

Magtape file support source file for system generation 

Keyboard monitor source file for system generation 

Keyboard monitor overlay source file for system generation 

Logical disk subsetting handler source file for system gener- 
ation 

Line printer handler source file for system generation 

Serial printer handler source file for system generation 

Multiterminal programmed request source file for system 
generation 

Multiterminal interrupt service source file for system gener- 
ation 

Null handler source file for system generation 

High-speed paper tape handler source file for system genera- 
tion 

PDT-11 handler source file for system generation 

RF11 handler source file for system generation 

RK05 handler source file for system generation 



(continued on next page) 
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Table 2-1: RT-11 Software Components (Cont.) 



Type of 
Software 



Description 



RMONFB.MAC 
RMONSJ.MAC 
SJ.MAC 
SP.MAC 

TJ.MAC 

TM.MAC 

TRMTBL.MAC 

TS.MAC 

TT.MAC 

USR.MAC 

VM.MAC 

XC.MAC 

XL.MAC 



FB/XM resident monitor source file for system generation 

SJ resident monitor source file for system generation 

SJ conditional source file for system generation 

Transparent print spooler handler source file for system gen- 
eration 

TJU16 handler source file for system generation 

TM11 handler source file for system generation 

Multiterminal table source file for system generation 

TS11 handler source file for system generation 

TT.SYS source file for system generation 

USR source file for system generation 

VM.SYS source file for system generation 

Professional communication port modem handler source file 
for system generation 

DL-11 communication port modem handler source file for 
system generation 



XM.MAC 
XMSUBS.MAC 



XM conditional source file for system generation 
XM monitor subroutines for system generation 
Unsupported Software 

CONFIG.COM Automatic system software configuration command file 

Automatic system software configuration services program 

Change boot-time console terminal 

Customization symbol location file 

Date and time source file for system generation 

Date and time utility 

System activity monitor 

File split utility 

RT-11 version 5 release notes 

Virtual RUN utility 

VT11 macro library 



CONFIG.SAV 

CONSOL.MAC 

CUSTOM.TXT 

DATIME.MAC 

DATIME.SAV 

RTMON.REL 

SPLIT.SAV 

V5N0TE.TXT 

VBGEXE.SAV 

VTMAC.MAC 



2.3 Selecting Components for Your Working System 

Because space on volumes is limited, you should include in your system 
only those components that are essential to your application. To decide 
which components these should be, study the space limitations of your par- 
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ticular device, then consider the suggestions given for each software compo- 
nent (Sections 2.3.1 through 2.3.14). 

Before selecting components, you should become familiar with your me- 
dium's space limitations. (See Table 2-2.) Establish how many blocks are 
occupied by the components residing on each volume and how much free 
space is available on the volume. 

Table 2-2: Device Size 



Device 


Device 

Name 


Size 

in 

Blocks 


RX01 Diskette 


DX 


486 


RX02 Diskette 


DY 


974 


RK05 Disk 


RK 


4.8K 


RL01/02 Disk 


DL 


10.2/20.4K 


RK06/07 Disk 


DM 


27.1/53.7K 


RX50 Diskette 


DU,DZ 


786 


RD50 Disk 


DU,DW 


9.7K 


RD51 Disk 


DU.DW 


19.6K 


RC25 Disk 


DU 


43K (approximate) 


RA80 Disk 


DU 


220K (approximate) 


Virtual Memory 


VM 


Variable, depending on 
physical memory available 



You should keep in mind the number of blocks various components occupy 
when you select the components for your working system. Also keep them 
in mind when you decide how to arrange these components on volumes. In 
addition, remember that you may need space for data storage on your sys- 
tem volume and other volumes in the working system. 

Although you will probably find it more efficient to select components for 
the working system before actually starting installation, you can also ex- 
amine volume directories during the installation process to get the compo- 
nent size information. Once you have booted the system, begun the installa- 
tion process, and backed up the distribution media, you can examine a 
backup volume's directory (or the directories of each backup volume if there 
are more than one). To examine a directory, you will use the DIRECTORY 
command. The following is a sample directory. 



17-SEP-8: 



SNAP .SYS 




ZB 


2S-AUG-B2 


RT11FB 


, SYS 


86 


26- 


-AUG- 


-B2 


DIR , SAU 




18 


2S-AUG-B2 


RK 


,SYS 


3 


26- 


-AUG- 


-82 


DX .SYS 




3 


2B-AUG-S2 


DL 


.SYS 


4 


2G- 


-AUG- 


-82 


PIP .SAU 




23 


2B-AUG-82 


DUP 


.SAU 


a3 


26- 


-AUG- 


-82 


FORMAT. SAU 




20 


2G-AUG-82 


RESORC 


.SAU 


20 


26- 


-AUG- 


-82 


RT11FB.SYS 




BG 


2B-AUG-B2 














10 FILES > : 


233 


BLOCKS 














735 FREE BLOCKS 

















Preparing for Installation 2—9 



You can also find the total free space on an initialized blank volume by 
obtaining a directory of the volume. 

Once you have examined the software kit maps, read the following sections. 
The suggestions given in these sections may help you make your selections. 
The following elements are described. 

1. Monitor 

2. SWAP.SYSFile 

3. System Device Handler 

4. Other Device Handlers 

5. Default System Library 

6. Exercises 

7. Help Package 

8. Line Printer Handler 

9. MACRO Assembler 

10. Queue Package 

11. Source Files 

12. Start-up Command File 

13. Text Editors 

14. Utility Programs 

As you make selections, record your choices on the worksheet at the end of 
the chapter (Figure 2-2). 

2.3.1 Monitor 

In general, you need only one monitor on a working system. If you do need 
more than one monitor, build a different system volume for each monitor. 
When your system device is a large disk, you may have room for several 
monitors. 

2.3.2 SWAP.SYS File 

You need the file SWAP.SYS on a system volume to serve as temporary 
storage for part of a program in memory when KMON, the USR, or both 
must swap over that program. When KMON or the USR are no longer 
needed, the system reads this external swap file back into main memory. 
The keyboard command, SET EXIT NOSWAP, precludes the necessity of 
using SWAP.SYS once you have bootstrapped the system. However, you 
must have the SWAP.SYS file on your distribution disk in order to boot- 
strap your system successfully. 
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2.3.3 System Device Handler 

You need a system device handler on each system volume. For example, if 
you build an FB system with RL02 as the system device, the file DL.SYS 
must be on the system disk. 

2.3.4 Other Device Handlers 

In addition to the system device handler, you need the device handlers for 
the other peripheral devices in your configuration. You do not need handler 
files for any devices you do not have. You must have TT.SYS (the terminal 
handler) on your system volume if you plan to use a BL monitor or a non- 
multiterminal SJ monitor. However, the FB, XM, and multiterminal SJ 
monitors each contain an integral, resident TT handler, so you need not 
have TT.SYS on your system volume if you plan to use any of those moni- 
tors. 

2.3.5 Default System Library 

To use the LINK utility program, you may need the file SYSLIB.OBJ, the 
default system library, which the RT-11 linker searches to resolve any 
undefined globals at the end of a linking operation. 

Generally, SYSLIB for your application should contain the system sub- 
routines (the file SYSLIB.OBJ found in the software kit), installation-spe- 
cific libraries of application subroutines, and the FORTRAN OTS routines. 
If SYSLIB must contain application subroutines and language routines, 
you must customize it to include these routines. If you intend to link over- 
laid files, you need SYSLIB, because it contains the overlay handlers. If you 
are a MACRO-only user, requiring only the overlay handlers in SYSLIB 
(and not the other routines), you can create a separate library containing 
only the overlay handlers by using the EXTRACT option with the LI- 
BRARY command. You can name the new, smaller library SYSLIB. Sec- 
tion 2.7.10 describes the procedure for creating such a library. Section 
2.7.10 also describes adding the overlay handlers to another library (for 
example, FORLIB or the DIBOL library) when the other library already 
exists. 

To add modules to SYSLIB from a file xxxxxx.OBJ, use the following com- 
mand, in which you need both the /REMOVE and /INSERT options. /IN- 
SERT inserts the new library or module in the old one; /REMOVE removes 
the duplicate global, $OVRH, from the library directory. You must remove 
$OVRH from the library directory for SYSLIB to function properly. This 
global appears in both overlay handlers, OHANDL and VHANDL, because 
VHANDL includes the program code found in OHANDL. VHANDL pro- 
cesses both unmapped and virtual overlays, while OHANDL processes only 
unmapped overlays. 

.LIBRARY/INSERT/REMOVE SYSLIB.OBJ x x x x x x . OB J© 
Global? *0VRH© 
Global? $ERRS(8E) 
Global? $ERRTB© 
Global? ffl) 



Preparing for Installation 2-11 



Note that you must also remove the globals $ERRS and $ERRTB from the 
library directory if you have included the FORTRAN library in SYSLIB. 

Refer to the RT-11IRSTSIE FORTRAN IV User's Guide for instructions on 
creating in-line code versions of GETSTR and PUTSTR and replacing 
threaded code modules in a library with in-line code modules. 

2.3.6 Exercises 

If you intend to perform the exercises in Introduction to RT-11, you need 
the following components on the system volume: 

SWAP. SYS 

RT11FB.SYS 

xx. SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

Other handlers if appropriate 

DIR.SAV 

PIP.SAV 

DUP.SAV 

LINK.SAV 

EDIT.SAV 

SRCCOM.SAV 

RESORC.SAV 

LIBR.SAV 

MACRO.SAV 

CREF.SAV 

SYSMAC.SML 

ODT.OBJ 

DEMOED.TXT 

DEMOX1.MAC 

DEMOBG.MAC 

DEMOFG.MAC 

To do FORTRAN IV exercises in Introduction to RT-11, you also need: 

FORTRA.SAV 

SYSLIB. OBJ (with FORLIB.OBJ included in it if possible) 

FORLIB.OBJ (if not included in SYSLIB.OBJ) 

DEMOF1.FOR 

To do BASIC-11 exercises in Introduction to RT-11, you also need: 

BASIC.SAV 

If the system volume is an RX01, RX02, or RX50, you will not have room 
for all components on the system volume. See Section 2.4.5 for the file 
arrangement you should use. 

2.3.7 Help Package 

HELP.SAV consists of HELP.EXE and HELP.MLB (resulting file after the 
librarian, LIBR, processes HELP. TXT) merged into a ready-to-use utility. 
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Unless you want to change the help text, HELP.SAV is the only file you 
need. 

Section 2.7.14 describes how to customize the help text to your specific 
needs/ 

'■"■ . / i 

2/3.8 Line Printer Handlers 

The software kit includes the line printer handler, LP. SYS, and the serial 
printer handler, LS.SYS. If your hardware configuration includes a serial 
printer instead of the usual line printer, you should include only LS.SYS in 
your working system. 

You can use the serial printer in the same way you use a line printer. On 
your working system volume, rename the original LP. SYS file to some- 
thing else in order to save it. Then, rename LS.SYS to LP. SYS. 

• RENAME LS.SYS LP. SYS®) 
' BOOT SY:(H) 

You must reboot the system after renaming the handler so the proper han- 
dler will be installed in the device table. Then, when you use the PRINT 
command, the system sends output to the serial printer. Since you will 
store both the distribution medium and the backup volume(s) you make 
during the installation process, you will always have copies of both han- 
dlers. 

If your serial printer is installed at nonstandard vector and control status 
register addresses, you can use the SET command to change the addresses. 
(See Section 2.7.11.1.) Note, however, that once you have renamed 
LS.SYS to LP. SYS, you must use the device name LP: in a SET command. 
The available SET options would still be those for the LS handler. 

2.3.9 MACRO-11 Assembler 

If you intend to use the MACRO-11 assembler, you need the files 
MACRO. SAV and SYSMAC.SML (the system macro library) on the system 
volume. See the RT-11 System Utilities Manual for a description of the 
assembly process. 

2.3.10 Line Printer Utilities 

RT-11 contains two utilities, QUEUE and SPOOL, that are used to send 
output to the printer. Both utilities run with the FB and XM monitors only, 
and can be used as foreground or system jobs. You must perform the system 
generation process to generate support for system jobs under the FB moni- 
tor. 

To use QUEUE, you need the files QUEUE. REL (which queues and prints 
the files you specify) and QUEMAN.SAV (which processes command lines 
and sends the information to QUEUE.REL). When you run QUEUE, it 
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creates a temporary work file (QUFILE.WRK) on the system disk, which 
contains the queue of files. 

To use SPOOL, you need the files SPOOL.REL (which gathers the output, 
stores it in a work file, and sends it to the printer), and SP.SYS (FB monitor 
SPOOL handler) or SPX.SYS (XM monitor SPOOL handler). 

There are significant functional differences in QUEUE as opposed to 
SPOOL. Consult the RT-11 System Utilities Manual for a complete descrip- 
tion of each utility. For information on system job support, consult the 
RT-11 System Generation Guide. Section 2.7 in this manual contains soft- 
ware customizations for these utilities. 

2.3.11 Source Files 

Normally, you do not need any source files in your working system except 
demonstration sources. Otherwise, the source files (file type .MAC) are re- 
quired only for the system generation process. 

You need the demonstration sources in the working system to perform the 
exercises in Chapters 3 through 11 of this manual and in Introduction to 
RT-11. Once you have finished these exercises, the demonstration source 
files are no longer useful and can be deleted from your working disk. 

2.3.12 Start-Up Command File 

The standard RT-11 monitors look for a start-up command file 
(STARTx.COM) whenever you bootstrap the system. If they find one, the 
monitors execute its commands (to print a message, assign devices, and so 
on). If the monitors do not find a start-up command file, they print a mes- 
sage indicating that the start-up file has not been found. You do not need a 
start-up command file unless you want one; you can delete the distributed 
start-up files or create your own. Refer to the RT-11 System User's Guide 
for more information about start-up command files. 

2.3.13 Text Editors 

RT-11 gives you a choice of three text editors. EDIT is a character-oriented 
text editor that you can use with either a hard-copy terminal or a video 
terminal. The Keypad Editor (KED or K52) is an easy-to-use, cursor-ori- 
ented editor that you can use only on a VTlOO-compatible or VT52 video 
terminal. 

Generally, you need only one editor in your working system, although you 
may want to try out one or two of these editors before choosing the one you 
prefer. Refer to the RT-11 System User's Guide and the PDP-11 Keypad 
Editor User's Guide for descriptions of these editors. 

You need the file EDIT.SAV if you choose EDIT as your text editor. 

If you choose the keypad editor, the file you need depends on the type of 
terminal you have. You need the file KED.SAV if your terminal is a 
VTlxx; you need K52.SAV if your terminal is a VT52. 
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2.3.14 Utility Programs 

You do not need any system utility programs you do not intend to use, but 
remember that most of the keyboard monitor commands need certain sys- 
tem progiams in order to work. For example, PIP, DUP, and DIR are neces- 
sary for most of the keyboard commands to function. Appendix A of the 
RT-11 System User's Guide summarizes the keyboard monitor commands 
and lists the system utility programs that each command requires. 

Refer to the RT-11 System Utilities Manual for descriptions of the func- 
tions of the utility programs. If your system device is a large disk, you will 
probably find it useful to have most of the utility programs on your working 
system device. On the other hand, if you have a small system device, you 
will not have room for all the utilities. 

In addition to PIP, DUP, and DIR, you probably need to use an editor, 
LINK, FORMAT (for certain devices), and HELP frequently, and you may 
want them on the system volume. However, the utilities you use less fre- 
quently can occupy a second volume, which you can insert in and run from 
Unit 1. 

2.4 Planning the Arrangement of Components 

Planning the arrangement of components will enable you to use your sys- 
tem most efficiently. If your system volume is one of the smaller devices, 
this planning is especially important. Therefore, consider the following 
suggestions before you build a working system; they can help you create an 
efficient system. 

1. Assign the default device to the data device. 
2: Create a separate utilities volume. 

3. Create bad blocks on TU58 DECtape II cartridges to avoid excessive 
rewinds. 

4. Create several system volumes. 

5. Create volumes for use with Introduction to RT-11. 

6. Limit components on the system volume. 

More details on each of these suggestions follow. (You can use the 
worksheet at the end of this chapter, Figure 2-2, to record the arrangement 
as you plan it.) 

2.4.1 Assigning the Default Device to the Data Device 

Once you have installed the system and it is running, you can assign the 
default device DK: to the data device (Unit 1). Most temporary files, data 
files, and others default to the second unit, minimizing demand for system 
device capacity. 
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The command to assign the default device to Unit 1 is as follows: 

■ ASSIGN xx 1 : DK s SB) 

You can include this command in your start-up command file to assign the 
default device to xxl: whenever you boot the system. The procedures in this 
manual assume DK: is the system device unless indicated otherwise. (See 
the RT-11 System User's Guide.) 

Be sure to make any adjustments in your procedures if you assign the 
default to the data device. 

2.4.2 Creating a Separate Utilities Volume 

Create a separate utilities volume for the utility programs you expect to 
use infrequently. This technique will provide you with a system volume 
containing all the components necessary to execute the majority of key- 
board commands and perform common program preparation functions. 
When you need a seldom-used utility, you can insert the utilities volume in 
Unit 1 instead of the data volume. You can then run a non-overlaid utility 
directly from the utilities volume (or you can copy the utility temporarily to 
the system volume). 

NOTE 

The PIP and DUP utilities must always reside on the system 
volume. 

To run a non-overlaid utility from the utilities volume, use the following 
commands, where xx is the physical device name, and aaaaaa is the utility 
program's name. 

, RUN xxl: aaaaaa®) 
# 

Replace the utilities volume in Unit 1 with the data volume, and issue the 
appropriate commands to the utility. 



* (CTRL/C) 



However, if you run an overlaid utility from Unit 1, the volume containing 
that utility must remain in Unit 1 at all times. Therefore, you should 
generally include the overlaid utilities on your system volume. The over- 
laid components are PIP, DUP, MACRO, LINK, LIBR, KED, K52, FOR- 
MAT, HELP, IND, BUP, SPOOL, and VTCOM. 

ODT.OBJ is also useful on the system volume to debug MACRO-11 pro- 
grams. 
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An example of this kind of arrangement of volumes into a system volume 
"\ and a utilities volume follows: 

System Volume Utilities Volume 

SWAP.SYS FILEX.SAV 

RT11FB.SYS SIPP.SAV 

DX.SYS BINCOM.SAV 

LP.SYS SRCCOM.SAV 

IND.SAV DUMP.SAV 

PIP.SAV RESORC.SAV 

DUP.SAV PAT.SAV 

DIR.SAV FORMAT.SAV 

KED.SAV BUP.SAV 
MACRO.SAV 
LINK.SAV 
LIBR.SAV 

j ODT.OBJ 

1 HELP.SAV — required for the HELP command 

2.4.3 Creating Bad Blocks on TU58 DECtape I! Cartridges 

If your volumes are TU58 DECtape II cartridges, you may encounter slow 
response time due to excessive rewinds of the tape. Because of the way 
DECtape II stores data in records, you can actually improve system per- 
• formance by creating dummy bad blocks in strategic locations. DECtape II 
) writes data records in a specific sequence and pattern; to write an entire 

cartridge, for example, it performs the following actions. 

1. Writes alternate data records on the first track. 

2. Rewinds to return to the beginning-of-tape (BOT) mark. 

3. Writes data records skipped on the first pass of the first track. 

4. Rewinds the tape. 

; 5. Writes alternate data records on the second track. 

6. Rewinds the tape. 

7. Writes data records skipped on the first pass of the second track. 

Performance degradation occurs when a file (particularly a monitor file) 
overlaps from the end-of-tape to the beginning-of-tape; for example, it ex- 
tends from the last portion of the second pass on track 1 to the first portion 
of the first pass on track 2. 

You can create dummy bad blocks in three locations: 

• Block 128 (decimal), at the beginning of the second pass on track 1 

9 Block 256 (decimal), at the beginning of the first pass on track 2 

\ * Block 384 (decimal), at the beginning of the second pass on track 2 
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This arrangement prevents the system from writing across rewinds, since 
RT-11 requires contiguous free space in which to write files. However, this 
technique prevents you from creating any file over 127 (decimal) blocks 
long and also increases fragmentation. Figure 2-1 illustrates the location 
of blocks on tape. 



Figure 2-1: Block Locations on DECtape II 




510 



254 




EOT 



EOT 



To create these dummy bad blocks, insert an initialized blank volume 
(write-enabled) in Unit 1 and type the following commands: 

.CREATE /ST ART: 12B. xxl :FIL1 .BAD© 
,CRE ATE/START: 25B. xxi : F I L2 , BAD© 
,CREATE/START:384. x x 1 : F I L3 . BAD© 



Repeat this procedure on all the cartridges for your working system, Then, 
when you build your system, use the volumes on which you have created 
these bad blocks. 

NOTE 

If you create these dummy bad blocks, you should consider 
them a permanent part of the cartridge (unless you reinitial- 
ize it). You can use the DELETE command to remove dummy 
bad blocks only if you have not compressed the cartridge with 
the SQUEEZE command. SQUEEZE renames bad blocks in 
such a way that you cannot type the file name to delete the 
file. 



2.4.4 Creating Several System Volumes 

Create several system volumes, each devoted to a particular function. You 
can then change the system volume as normal job flow changes the func- 
tions you need. To change system volumes, wait for a logical stopping point 
in the job flow; do not arbitrarily remove the system volume in the middle 
of an operation. Be sure to copy the bootstrap record to each system volume. 



2.4.5 Creating Volumes for Use with Introduction to RT-11 

If you intend to perform the exercises in Introduction to RT-11, you need 
certain components on your working system. If your system device is one of 
the small devices (RX01, RX02 or RX50), you need to build four volumes, 
which are listed below with the files they contain. Be sure to copy the 
bootstrap to each volume. 



2—18 Preparing for Installation 



System Volume 

SWAP.SYS 

RT11FB.SYS 

PI. SYS (if running on Professional 325) 

xx. SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

LINK.SAV 

EDIT.SAV 

SRCCOM.SAV 

RESORC.SAV 

LIBR.SAV 

IND.SAV 

ODT.OBJ 

MACRO.SAV 

SYSMAC.SML 

CREF.SAV 

DEMOED.TXT 

DEMOF1.FOR 

DEMOX1.MAC 

DEMOBG.MAC 

DEMOFG.MAC 

FORTRAN IV Language Volume 

SWAP.SYS 

RT11FB.SYS 

PI.SYS (if running on Professional 325) 

xx.SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

EDIT.SAV 

FORTRA.SAV 

DEMOF1.FOR 

LINK Volume 

SWAP.SYS 

RT11FB.SYS 

PI.SYS (if running on Professional 325) 

xx.SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

LINK.SAV 

SYSLIB.OBJ. (including FORLIB.OBJ) 

FORLIB.OBJ (if not included in SYSLIB.OBJ) 
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BASIC-11 Language Volume 

SWAP.SYS 

RT11FB.SYS 

PI. SYS (if running on Professional 325) 

xx. SYS (system device handler) 

LP.SYS or LS.SYS (if appropriate) 

PIP.SAV 

DUP.SAV 

DIR.SAV 

LINK.SAV 

EDIT.SAV 

BASIC.SAV 

SYSLIB.OBJ 

2.4.6 Limiting Components on the System Volume 

Limit the system volume to necessary and frequently used system compo- 
nents. Place on the system volume only one monitor file and only the han- 
dler files for devices in your configuration. For example, a typical RX01 
system volume need have only: 

SWAP.SYS 

RT11FB.SYS 

DX.SYS (RX01 device handler) 

LP.SYS (if your system includes a line printer) 

The device handler is not included in the monitor file, so you must include 
the system device handler on any system volume. If you use the BL monitor 
or the SJ monitor without multiterminal support, you do need TT.SYS, 
because the terminal service is not resident in those monitors. 

However, if you intend to use the keyboard monitor commands, you need to 
include at least the utility programs PIP, DUP, and DIR, which are neces- 
sary for most of the keyboard commands to function. The programs EDIT, 
KED, LINK, and HELP are also used frequently. 

2.5 installing Software Updates 

To make sure that RT-11 operates correctly, you must install software 
updates. Software updates are critical to system or component operation. 

Software updates are performed to provide normal maintenance; for exam- 
ple, to correct documentation or software errors detected since the last soft- 
ware release. These updates also introduce new software functions that are 
not described in the documentation; for example, an update would be re- 
quired to support new hardware, to release a bundled layered product, or to 
support a released layered product. 

Software updates are distributed, not as source modules or binary patches, 
but as complete software module replacements. For example, if a software 
error exists in the PIP utility program, the update kit will contain the 
complete PIP software module. The correction will already have been in- 
stalled and fully tested. Your only requirement is to copy the new module 
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from the distribution medium to your system, replacing the old software 

module with the new. After completing the update, you may be required to 

/ perform part of the installation procedure, for example, to rebuild your 

working system. 

When you submit an SPR, the RT—11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to the problems until 
the module in error is replaced. 

Each software update kit includes: 

9 A letter from Software Product Services 

8 Release notes — identify the contents of the update kit, list the known 
problems that the kit fixes, and provide any special information about the 
update. 

8 User documentation — provides instructions on how to update the sys- 
tem. 

) 

9 Distribution medium — contains new software modules and IND proce- 
dures to automate the updating process. 

The distribution medium is the same as the medium on which you received 
the base system. It contains modules for both base system and layered 
products. 

For a complete description of how to update your software, refer to the 
\ RT-11 Update User's Guide. 

2.6 Acquiring Sufficient Media 

When you perform the installation procedures, you need blank media on 
which to make backup copies of the distribution, create a working system, 
and make backup copies of the working system. For example, if you receive 
RT-11 on nine RX01 diskettes, you need at least 11 blank diskettes, for the 
following purposes. 

J 9 to back up distribution 

1 (or more) for working system 

1 (an equal number) to back up working system 

? for your application's data storage requirements 

11+ total 

Before you begin installation, read over the installation chapter that per- 
tains to your configuration and establish how many cartridges, diskettes, 
disks, or magtapes you need. Then you can secure additional media, if 
required. 

2.7 Choosing Software Customizations 

Although the RT-11 components as distributed need no alteration for most 
) applications, you can alter them in some ways. Many alterations require 
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your going through the system generation process. Others require less 
time-consuming procedures, such as modifying the distributed monitors. 
Compare Tables 1-3 and 1—4, and read the following sections to establish 
what you need to do. Identify any non-system-generation customizations 
you need to make, and record them on the worksheet at the end of this 
chapter (Figure 2-2). You can perform the procedure for each selected cus- 
tomization during the installation process (Chapters 3 through 11). System 
generation is necessary only if you need a customization that cannot be 
achieved with one of the procedures described in the following sections. 

NOTE 

Refer to Appendix D in the RT-11 System Generation Guide 
for additional modifications that further customize specially 
generated monitors. 

DIGITAL strongly recommends that you use the SIPP utility to install 
software customizations. Also, use the feature of SIPP that creates an indi- 
rect command file when it installs the customization. In this way, you can 
store copies of the indirect command files, so that you can easily install the 
customizations again if necessary. When you invoke SIPP and it responds 
with an asterisk, enter the following: 

.RUN SIPP® 

*filnaM.COM = filriam. typ/L© 

The equal sign and file name cause SIPP to create the indirect file, and /L 
causes SIPP not to customize the input file. You can use the indirect file to 
customize whenever necessary. 

In order to customize your software, you must: 

1. Determine which customization(s) you wish to make. 

2. Locate the symbol of the software component you wish to modify. The 
values of symbols for monitor customizations may be obtained from the 
link maps distributed with RT-11 as the files RTBL.MAP, RTSJ.MAP, 
RTFB.MAP, and RTXM.MAP. The values of symbols for utility custom- 
izations may be found in the file CUSTOM.TXT. 

3. Follow the instructions to modify the software component, substituting 
the actual address value of the symbol in place of the symbol in the 
update. 

NOTE 

In the software customizations reproduced in this manual, 
lowercase alphabetic x represents unknown characters. 
These characters vary according to the specific software com- 
ponent. All numeric input values are octal. 

2.7.1 Changing Characters That Indicate Insertion/Deletion 

You can modify SRCCOM to change the default characters that SRCCOM 
uses to indicate insertions and deletions on listings. Normally, when you 
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use the DIFFERENCES/CHANGEBAR command or SRCCOM's /D option 
to compare two files, SRCCOM places vertical bars next to each line that 
has been added to the new file and bullets (lowercase alphabetic o) next to 
lines that have been deleted. If you want to use characters other than the 
vertical bar and bullet characters, you can modify SRCCOM. 

In the following customization, n is the ASCII code for the character you 
want to use to indicate insertions, and m is the ASCII code for the character 
you want to use to indicate deletions. 



. RUN SlPPdH 
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Base? 0© 








Offset? 1000(E) 






Base 


Offset 


Old 


New? 


(") 


1 


07G157 


iftdJ 





1 


< o > 


;am(Ej 





1 1 


\ 1 .•' 


iAndS) 





1 2 


< - c > 


(CTRL/YKRETl 


#lCTRL/C) 





2.7.2 Changing Default Output Device from Line Printer to 
Terminal 

If your configuration does not have a line printer, you can cause monitor 
commands to default to the terminal (TT) instead of the line printer (LP). 
Since several monitor commands default the output device to LP, you 
should edit the start-up command file to cause all system references to the 
device LP: to use the terminal. To change the defaults of such commands 
(for example, DUMP and PRINT), you need to add an ASSIGN TT: LP: 
command to the start-up file. Then, every time you bootstrap the system, 
the reassignment of the default device takes place. 

2.7.3 Changing Location of VT11/VS60 Floating Vectors 

Under certain circumstances, you may need to change the VT11/VS60 vec- 
tor address. VT11/VS60 display processor vectors are normally located at 
320 to 332, However, the floating vector region on the PDP-11 is situated 
in locations 300 to 476. Therefore, you may have to move the VT11/VS60 
vectors if you add other devices. 

If the vectors for your VT11/VS60 change, install the following customiza- 
tion to modify the monitor for a different VT11/VS60 vector address. Once 
you have made this change, all DIGITAL supplied software that accesses 
the display will function properly on the system without further altera- 
tions. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, $RMON is the value of that symbol from the appropriate 
monitor link map, and nnn is the location of the first VT11/VS60 vector on 
your system. Find the monitor link map for the monitor you want to alter, 
and use the value of $RMON in the update. Note that nnn must be an even 
octal value between 70 and 464. 
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, RUN SIPPdD 
♦ moni t r.SYSdED 
Base? $RMON© 
Offset? 354© 
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2.7.4 Changing the Number of Directory Columns 

You can modify DIR to change the number of columns in the directory 
listing that prints when you use the DIRECTORY command. Normally, the 
directory contains two sets of three columns, with each set listing file 
names and types, file size in blocks, and date of creation. If you use the 
/FAST or /BRIEF option with DIRECTORY, DIR lists only file names and 
types in five columns. You can also use the /COLUMNS:n option to specify 
the number of columns in the directory listing. However, if you want to 
change the default number of columns in the directory listing, install the 
following change. 

In the customization, ffffff is an octal number (in the range 1 to 11) for the 
number of directory columns to be displayed when you use the DIREC- 
TORY/FAST command. The value nnnnnn is an octal number (in the range 
1 to 11) for the number of columns to be displayed when you use the DI- 
RECTORY command. 

, RUN SIPPdD 

*DIR.SAV(H> 

6a se? om 

Offset? 1000(H) 

Base Offset Old New? 

1 005 ffffff dH) 

1 2 2 n n n n n n © 

1 IX 5 @RL/T) (Sll) 



* tCTBUC) 



2.7.5 Changing the Defauit Order of Directory Listings 

You can change the default order in which directory entries are listed in a 
directory listing. The current default order is by position in the directory. 

In the following customization, SWS is the value of that symbol from the 
CUSTOM.TXT file. The variable nnnnnn represents the address of SWS 
that SIPP returns in response to the search command. The variable yyyyyy 
represents the contents of nnnnnn + 2. The variable zzzzzz requests the con- 
tents of SWS + 2. The variable xxx represents one of- the following default 
ordering options: 

DAT Order by date (earliest to latest) 

NAM Alphabetical order by file name 

POS Order by position in directory (current default) 

SIZ Order by size (smallest to largest) 

TYP Alphabetical order by file 'type 
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Did 


New? 


SNS 


SWS + 4© 




(CTRL Z )(RET) 


Did 


New? 





iRxxx© 


zzzzzz 


(CTRL, Y] (RET) 



. R SIPP© 

* DIR.SAV© 
Base? 0© 

offset? ;s© 

Search for? SWS© 
Start? © 
End? © 
F o u n d a t n n n n n n 
Offset? nn n n n n © 

Base Offset 
n n n n n n 
n n n n n n + 2 

Offset? SWS© 

Base Offset 

SNS 

S N S + 2 

* PrTc; 

2.7.6 Changing the Number of /Q Program Sections LINK Allows 

You can alter LINK to change the number of absolute base address p-sects 
(/Q p-sects) that LINK allows. Normally, the /Q option to LINK lets you 
specify the absolute base addresses of up to eight p-sects in your program. 
You need absolute base address p-sects to prepare programs in absolute 
loading format for use in read only memory (ROM) storage. Refer to the 
RT—11 System Utilities Manual for more information about absolute base 
address p-sects and about LINK in general. 

The limit of eight such p-sects, however, is the default number, and you can 
change it by- altering LINK. LINK uses the number of p-sects to set up the 
/Q buffer area and to establish how many times it should ask the question: 

Load section: address? 

Note, however, that LINK allocates the buffer space even if you do not use 
the /Q option when you perform the link. LINK calculates the size of the 
buffer to be three times the contents of QSWNUM. 

To change the number of /Q p-sects LINK allows, use SIPP to change 
LINK.SAV as follows. QSWNUM is the value of that symbol from the 
CUSTOM.TXT file. The number nnn must be in the range 1 to 177 (octal); 
it represents the number of p-sects you want. 

, RUN SIPP© 

* LINK. SAVES) 
Segment? ( ->© 
Base? 0© 
Offset? QSWNUM© 

Segment Base Offset Old New? 

000000 000000 QSWNUM ? nrm© 

000000 000000 QSWNUM + 2 ? (CTRL.'Y)© 
^ (CTlLTcl 

2.7.7 Changing the Size of LINK'S Library Module List 

You can modify LINK to change the default size of LINK'S list of library 
modules. LINK creates a list of 252 (octal) modules to be included from 
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libraries during the link operation. Because the size of each entry in this 

list is larger in RT-11 Version 5 than in previous versions, the list may not i 

be large enough for your application. You can use the LINK /P option at 

link time to increase the size of this list. If you want to change the default 

size of the list (and avoid using the /P option), you can modify the linker. 

You can still override the new default at link time by using /P. 

Note that if you increase the default size of the list, the maximum number 
of global symbols allowed in the link will be reduced. 

NOTE 

You must install this change if you use DIBOL. Make the 
default number of modules LINK holds 400 (octal) or greater. 

In the following customization, LMLSIZ is the value of that symbol from 
the CUSTOM.TXT file, and nnnnnn is the number of modules the list 
should hold. 

, RUN SIPP© ) 

♦ LINK.SAV© 
Segment? 0© 
Base? 0© 
Offset? LMLSIZ© 

Segment Base Offset Old New? 

00 LMLSIZ ? nnn n n n © 

0000 000000 LMLSIZ + 2 ? (CTRL/Y I fRET) 

♦ JCTRiJcl 

i 

2.7.8 Changing the Size of the QUEUE Work File 

QUEUE, the device queue foreground program (or system job), uses a work 
file five blocks long. This work file allows you to queue approximately 127 
(decimal) files at once. If your application requires larger queues, you can 
modify QUEUE. REL to change the default size of the work file. 

In the following customization, QSIZE and QCBLK are the value of those 

symbols from the CUSTOM.TXT file, and nnn is the default size of the 

work file in octal blocks. To compute the approximate size of the work file ) 

that would be required for the number of files you need queued at once, use 

the formula: 

nnn = (max no. of file specs in queue at one time + l)/32 + 1 

. RUN SIPP© 

♦ QUEUE. REL/A© 
Base? 0© 
Offset? QSIZE© 

Base Offset Old New 
QSIZE 5 ' ri n n © 



00 Q S I Z E + 2 (CTRL/z ) (REf) 

Offset? QCBLK© 

Base Offset Old New? 

QCBLK U < n n n - 1 ) © 

000000 QCBLK + 2 000200 < nnn- 1 ) *32(! 

000000 QCBLK + 4 000000 JCTRL/yK reD 



* CTBL/c) 
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2.7.9 Modifying EDIT 

To customize the editor, EDIT, you can reduce the size of the editor's text 
window and you can cause the editor to operate correctly on terminals with 
nonstandard ESCAPE codes. 

2.7.9.1 Size of the Text Window — If your configuration includes a 
VT11/VS60 display processor, you may need to reduce the size of the edi- 
tor's text window to correct an overflow problem. The editor works in such a 
way that when you use a VT11 or VS60, the window into the buffer and the 
scrolled command lines are separate "pictures". On rare occasions, if the 
text window around the cursor (Contains long lines and several line feed (or 
form feed) characters, the window may overflow onto the scrolled editing 
commands, making that portion of the screen difficult to read. While this 
problem does not usually occur, if it does, you can make the obscure lines 
clear by advancing the cursor several lines. 

However, if the problem is troublesome for your particular application, you 
can remove it by reducing the size of the display window. Use the following 
customization to make this change, where DSARG is the value of that 
symbol from CUSTOM.TXT file, and nnn is the number of lines to be dis- 
played above and below the cursor. To eliminate the problem, make nnn, 
smaller than 12 (octal). 

.RUN SIPPED 
* ED IT. SAVED 
Base? OED 

Offset? DSARGED 

Base Offset Old New? 

000000 DSARG 000012 nnn ED 



00 D S A R G + 2 1 2 (CTRL/Y ) 



* (CTRL/C] 



2.7.9.2 Terminals with Nonstandard ESCAPE Codes — You can modify the 
editor to allow it to operate correctly on terminals with nonstandard ES- 
CAPE codes. Certain older terminals generate 175 or 176 (octal), rather 
than the standard 33 (octal), when you type the ESCAPE or ALTMODE 
key. Because codes 175 and 176 represent legitimate characters on more 
modern terminals, EDIT does not recognize ESCAPE code as the command 
terminator in the older terminals. 

If you have an older terminal, you can correct the problem by making the 
following change, so that you can use the ESCAPE code as documented in 
the EDIT chapter of the RT-11 System Utilities Manual. In the change, 
ALTMDE is the value of that symbol from the CUSTUM.TXT file, and nnn 
represents the octal code that your terminal generates when you type the 
ESCAPE key on it. 

. RUN SIPPED 
* ED IT. SAVED 
Base? OED 
Offset? ALTMDEED 
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Base Offset Old New 
000000 ALTMDE hook @H) 



Base 
1") 


Offset 
ALTMDE 
ALTMDE+1 


Old 
033 
01G 


New? 
nrml 





CTRL/Y) 


(CTHL/C) 





The character $ echoes on the terminal, regardless of the octal value used 
for the ESCAPE code. However, EDIT recognizes only the ESCAPE code 
you specify, not both. 

2.7.10 Extracting the Overlay Handlers from SYSLIB 

You can extract the overlay handlers from the default system library, SYS- 
LIB, if those are the only components of SYSLIB you need. Remember that 
you need the overlay handlers that are included in SYSLIB if you intend to 
use overlaid programs. 

Create a separate library containing only the overlay handlers by using the 
/EXTRACT option to the LIBRARY command, as described in the following 
procedure: 

1. Extract the unmapped overlay handler (for LINK/O overlays) from 
SYSLIB: 

.LIBRARY/EXTRACT SYSLIB OHANDL© 

Global? SOVRHED 

Global?© 

2. Extract the virtual overlay handler (for LINK/V overlays) from SYS- 
LIB: 

.LIBRARY/EXTRACT SYSLIB UHANDLdD 

Global? SOVRHV© 

Global?® 



3. Combine the files you extracted in a new library (which can have any 
name, including SYSLIB). You must combine the files in the indicated 
order: 

.LIBRARY/REMOUE/CREATE newlib UHANDL .OHANDL© 

Global? *OURH(® 

Global?© 

In the command, you need both the /REMOVE and /CREATE options. 
/CREATE creates the new library, and /REMOVE removes a duplicate 
global, $OVRH, from the library directory. This global appears in both 
OHANDL and VHANDL, because VHANDL includes the program code 
found in OHANDL. Remember, VHANDL processes both unmapped 
and virtual overlays. 
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You can also put either handler in a library by itself. OHANDL handles 
only unmapped overlays. VHANDL handles both unmapped and extended 
memory overlays, but it is larger than OHANDL. 

In the following command, which creates a library from one of the overlay 
handlers, x is O for OHANDL or V for VHANDL. 

•LIBRARY/CREATE newlib xHANDLdH 



To add the overlay handlers to another library or module (for example, 
FORLIB or the DIBOL library), you can combine the distributed SYS- 
LIB.OBJ with the library or module. Use the LIBR utility, but remove the 
global $OVRH from the new library. You must remove this global if you 
use as input to LIBR any library that includes both overlay handlers (as 
does the distributed SYSLIB). In the following command to combine librar- 
ies, the /REMOVE option removes $OVRH. Note that newfile is a single 
module or a library, and gbl is any global that must be removed from 
newfile. If you combine FORLIB with SYSLIB, you must also remove the 
FORTRAN IV globals. (Refer to the FORTRAN library generation proce- 
dures.) 

•LIBRARY/REMOUE/INCLUDE SYSLIB newfiledD 
Global? $OyRH© 
Global? sblSSl 
Global? (RET) 



2.7.11 Installing Other Devices 

You may need to install device handlers that are available but are not 
installed in the standard monitors. Installing a device handler adds infor- 
mation to the monitor device tables, so that you can use the device. Many 
devices are available in the standard monitors. (Refer to the RT—11 System 
User's Guide for a list of available devices.) You can perform the system 
generation process to create monitors and handlers that support non- 
standard devices. The RT-11 Software Support Manual describes how to 
write your own device handler. 

When you bootstrap RT-11, the bootstrap routine locates the system device 
handler and installs it. Then the bootstrap looks at the rest of the device 
handler files on the system device and tries to install the device handler for 
each device it finds in the configuration. It does not try to install any 
handlers for which there is no hardware. If there are more handlers than 
device slots, the bootstrap uses a certain priority scheme to establish which 
handlers to install. Refer to the RT-11 Software Support Manual for a 
description of these priorities. 

To ascertain which device handlers have been installed, use the keyboard 
monitor SHOW command, which shows you which devices are installed and 
whether any empty device slots are available. 
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.SHOW® 

TT 

R K (Resident) 

RKO = SY i DK 
LD 
DX 
DT 
DD 
CT 
LS 
PC 
BA 
NL 
14 free slots 

If the bootstrap did not install a device when you booted the system, it did 
not have enough device slots when it encountered the handler, the hard- 
ware was not present, or the device handler was not present. To install a 
device ensure that the correct handler is on the system device and that the 
hardware is present. If there are no free slots, use the REMOVE command 
to remove an unneeded device and the INSTALL command to install the 
device you need. 

.REMOVE LSsSE) 
, INSTALL LP:®) 

The standard (distributed) monitors provide a total of 16 (decimal) device 
slots. If your application requires more than 16 device slots simultaneously, 
you must perform the system generation process to create your own moni- 
tor and device handlers. 

To control which handlers the bootstrap installs, place on the system device 
for your working system only the handlers for the devices you will be using. 
Do not include in your working system a handler for a device you will not 
be using. 

You can keep a handler from being installed at boot time by giving it a 
name that does not correspond to the naming conventions for the monitor 
being booted. A device handler is named yy.SYS for SJ and FB monitors 
and yyX.SYS for XM monitors (where yy is the device name). Use the 
RENAME command to rename a handler. 

The bootstrap cannot install support for some devices. Thus, different pro- 
cedures are required. The following sections describe how you can change 
the control status register (CSR) and vector addresses for the line printer, 
serial printer, DECtape II, RX01 and RX02 diskettes, and MSCP disks, and 
how you can install hardware magtape support, set magtape parity and 
density, and change RP02 support to RP03. 

2.7.11.1 CSR and Vector Addresses for Line Printers, DECtape II, and MSCP 
Disks — With the SET command, you can change the CSR and vector 
addresses of six devices: line printer, serial printer, DECtape II, RX01 and 
RX02 diskettes, and MSCP disks. You need to change the addresses if the 
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controller is installed at nonstandard addresses. When using the SET com- 
mand, enter the following commands, where dd is the device mnemonic 
(LP, LS, DD, DX, DY, or DU), aaaaaa is the CSR address, and bbb is the 
vector address. 

• SET dd: CSR2 = aaaaaa® 

• SET dds VEC2 = bbb© 

•SET dd: CSR = aaaaaa(HD 
•SET dd: YECTOR=bbb(E) 

In addition, the following commands are valid for MSCP disks: 

•SET DU: CSR3=aaaaaa® 

• SET DU: UEC3 = bbb© 

• SET DU: CSR4 = aaaaaa(SID 

• SET DU: VEC4 = bbb(Il) 

You can also partition MSCP disks and assign unit numbers to the ports. 
Use the following commands: 

•SET DUn: PART=x(®) 

where n = unit number 

x = partition number 

• SET DUn: P0RT=x© 

where n = unit number 
x = port number 

See the description of the SET command in the RT-11 System User's Guide 
and the RT-11 Software Support Manual for more information on parti- 
tioning MSCP disks and assigning ports. 

These commands permanently alter the handler .SYS file. That is, the CSR 
and vector addresses you specify remain in effect even if the system is 
rebooted. If you want to change the addresses again, you can use the SET 
command again. 

2.7.11.2 Hardware Magtape Support — You can choose to install hardware 
magtape support, rather than use file-structured magtape support. File- 
structured handlers include hardware magtape handler features; however, 
hardware magtape handlers are smaller. 

File-structured magtape handlers are distributed as part of the RT-11 op- 
erating system; hardware magtape handlers are not. If you want to use 
hardware magtape handlers, you must perform a system generation, using 
a new disk for output. System generation will produce either file-structured 
or hardware magtape handlers, but not both at the same time. 
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The files MT.SYS, MTX.SYS, MM.SYS, MMX.SYS, MS.SYS, and 
MSX.SYS are distributed file-structured handlers for TM11, TJU16, and 
TS11 magtape devices. The files MTHD.SYS, MTHDX.SYS, MMHD.SYS, 
MMHDX.SYS, MSHD.SYS, and MSHDX.SYS are the system-generated 
hardware magtape handlers for the same devices. There are two sets of 
handlers: one for SJ and FB monitors; the other for XM monitors. The file- 
name suffix X indicates device support for XM monitors. 

There are two ways to install a hardware magtape handler in place of the 
file-structured handler: 

1. Rename the distributed file-structured handler to save it, rename the 
corresponding hardware magtape handler to the original name of the 
file-structured handler, and reboot the system to let the bootstrap in- 
stall the handler. 

2. Use the INSTALL and REMOVE commands: 

® Make sure the hardware magtape handler for your monitor and de- 
vice is on the system disk. 

• Rename the distributed file-structured handler to save it. 

9 Remove the file-structured handler from the system volume. 

• Rename the corresponding hardware magtape handler to the name of 
the distributed file-structured handler. 

a Install the renamed hardware magtape handler. 

For example, to install TM11 hardware support in place of TM11 file-struc- 
tured support, first make sure that the hardware magtape handler 
MTHD.SYS is on the system volume, and then do the following: 

1. Rename and remove the file-structured handler. (You must remove the 
old handler before you can install the new one.) 

RENAME MT.SYS MT.FILt® 
'REMOVE MT:(© 



2. Rename and install the hardware magtape handler. 

( RENAME MTHD.SYS MT.SY 
'INSTALL MT:(E) 



The handler you have named MT.SYS will be installed in the device table 
when the system is bootstrapped. 

Table 2-3 identifies hardware handlers that you must rename, if you are 
using an SJ or FB monitor. Make sure you save the distributed (file-struc- 
tured) handler. 
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Table 2-3: File-Structured and Hardware Magtape Handlers for 
SJ and FB Monitors 



Device File-Structured Hardware 

Handler Handler 



Renamed Hardware 
Handler Name 



TM11 MT.SYS 
TJU16 MM.SYS 
TS11 MS.SYS 



MTHD.SYS MT.SYS 
MMHD.SYS MM.SYS 
MSHD.SYS MS.SYS 



Table 2-4 identifies hardware handlers that you must rename, if you are 
using an XM monitor. Make sure you save the distributed (file-structured) 
handler. 

Table 2-4: File-Structured and Hardware Magtape Handlers for 
XM Monitors 



Device File-Structured Hardware 

Handler Handler 



Renamed Hardware 
Handler Name 



TM11 MTX.SYS 
TJU16 MMX.SYS 
TS11 MSX.SYS 



MTHDX.SYS MTX.SYS 
MMHDX.SYS MMX.SYS 
MSHDX.SYS MSX.SYS 



2.7.11.3 Magtape Parity and Density — If you need to operate TM11 or 
TJU16 magtape at parity or density settings different from standard sup- 
port, you can use the monitor SET command as described in the RT-11 
System Utilities Manual to set them. The distributed monitors support 
seven- and nine-track TM11 and TJU16 magtape at 800 bits/in and odd 
parity. You cannot set the density of TSll magtape, since it is 1600 bits/in 
odd parity only. 

2.7.11.4 RP03 Support — RT-11 can accommodate the 40000 (decimal) 
block RP02 cartridge as a single logical unit but not the RP03, because the 
RT-11 file structure can accommodate only a maximum of 65536 (decimal) 
blocks. Therefore, to use RP03, think of each RP03 drive as two logical 
units of 40000 blocks each. (A single RP03 looks like two RP02 drives to the 
system.) Access the cartridge on physical unit n as logical DPn + 4; thus, 
refer to drive as DP0: and DP4:, drive 1 as DPI: and DP5:, and so on. Each 
logical unit has its own directory and data space. The system can support 
up to four RP03s. You can mix RP02s and RP03s as long as the total 
number of units (physical drives) on the system does not exceed four. The 
system can support as many as eight RP02s. 

2.7.12 Modifying BATCH to Save Space 

To minimize space demands on your system device, you can modify BATCH 
to access certain system programs on DK: rather than on SY:. These cus- 
tomizations allow you to store certain system programs on DK: rather than 
on SY: and let BATCH access them there. 
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You can make any or all of the customizations. Modify BATCH for the 
system programs you need to remove from the system device. Copy the 
programs for which you install changes to the device on which you want 
them to reside; then, delete them from the system device (SY:). Finally, use 
the ASSIGN command to assign the logical name DK: to the device to 
which you copied the system programs. Then, run BATCH as usual. 

The following change to BATCH makes DK: the default storage volume for 
one of the specified programs. Use the octal value of nnnnnn (from the 
table) that corresponds to the program you want to affect. 

Program Octal Value of nnnnnn 

1367 
2007 
2020 
2037 
2052 
2071 





DIR 








MACRO 








FORTRAN 








LINK 








PIP 








BASIC 






,RUN SIPP© 
*BATCH.SAy(H) 
Base? BASEdB 






Offset? 


n n n n n n EH) 






Base 


Offset 


Old 


New 


BASE 


n n n n n n 


X X X X X X 


EH) 


Base 
BASE 
BASE 
afcTRL/C) 


Offset 
n n n n n n 
n n n n n n + 1 


Old 
n 
1\ 


New 

125© 

(CTRL/YKRET) 



Once you assign DK: to a device other than SY:, the new device becomes 
the default input and output storage device for most system programs. You 
may need to modify BATCH jobs to reference certain files on SY: explicitly, 
since that is no longer the same device as DK:. You can keep .BAT and 
.CTL files on SY: by invoking BATCH as follows: 

.RUN BATCHES) 

♦S Y : in y J o b = S Y : m y J o b EH) 



2.7.13 Modifying LINK to Change the Default SYSLIB Device 

You can modify the linker to make it look for the default system library 
(SYSLIB. OBJ) on the device you choose instead of on the system device 
(SY:). This change may be useful if you have space problems on your sys- 
tem device, because you can then place SYSLIB on the device you have 
specified to LINK. 

To change the device on which SYSLIB. OBJ resides, make the following 
change to LINK.SAV. In the customization, dev is the name of the device 
on which you want to place SYSLIB. 
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• RUN SIPPED 

* LINK. SAVED 

Segment? oH 
Base? odD 
Offset? SYSLIBdD 

S e 3 in e n t Base Offset Old New? 

OOOOOO 000000 SYSLIB ? iRdevE) 

S Y S L I B + 2 ? ( CTRl/Y )(RET) 
* (CTRUC] 



2.7.14 Modifying the Help Text 

To change the help text that prints when you use the HELP command, you 
must create your own help text file, process that file with LIBR, and copy 
the resulting library and the file HELP. EXE to the same volume. 

The files HELP.TXT and HELP.EXE, which together make up the program 
HELP.SAV, are not provided on the distribution kit. Therefore, if you want 
to change your HELP text, you must first recreate HELP.TXT and 
HELP.EXE from HELP.SAV using the unsupported utility SPLIT. 

To recreate these files, type this command: 

•SPLIT ddn iHELP.EXE > > d dn : HELP . TXT= d dn : HELP . SAV/B : . . HLP1 : . . HLP2 

In the command, ddn: represents the device on which to create the files 
HELP.TXT and HELP.EXE, or the device on which HELP.SAV exists. The 
variables ..HLP1 and ..HLP2 represent the boundaries along which to split 
HELP.SAV. Refer to the file CUSTOM.TXT on your distribution kit for the 
values to substitute in the command line for ..HLP1 and ..HLP2. 

HELP.SAV is the only file you need if you do not want to change the help 
text. However, if you do want to change the text that prints when you use 
the HELP command, you must perform the following procedure. 

First, edit the file HELP.TXT in your working system. Make sure that this 
file (as well as the rest of the distribution) is safely backed up and the 
actual distribution media are stored away. Add any explanations your ap- 
plication requires and delete any explanations that do not apply to your 
application. 

When you edit HELP.TXT, you must follow a specific format, as follows: 

1. Give each topic in the file an alphabetic name. 

2. The name you give must be unique within the first six characters. 

3. Place each topic on a page, delimited by form feeds. (See the following 
example.) 

4. Place topics in alphabetical order within the file. 

5. Leave the dummy topic 999999 at the end of the file. 
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The following illustrates the format of a topic, properly formatted, on a 
page. 



MACROdfTOPICNAMEED© 
TDPICNAMEdlONE LINE DESCRIPTION OF THE TOPIC 



(DlDSUBTOPICNAMEEDEE) 
(UTEXT ABOUT THE SUBTOPICt! 
(IJMORE TEXT (ANY NUMBER OF LINES) 
JUBTOPICITEMNAMEEDGE) 
ASCRIPTION OF SUBTOPIC ITEM (USUALLY ONLY F0R(i 
GUT HE SUBTOPIC 'OPTION') , ANY NUMBER OF L I NESED© 
[ANOTHER SUBTOPIC, STARTING FROM THE BLANK LINE ABOVE] 
ENDMED© 



Now, create the help text library file by processing HELP.TXT with the 
librarian. Use the following command: 



LIBR/MACRO HELP. MLB HELP.TXT© 



You can leave HELP.MLB as a separate file or merge it with HELP. EXE. 

To run HELP with a separate program and text library file or files, copy 
HELP.EXE to the system volume. When you copy HELP. EXE, name it 
HELP.SAV. 

COPY/CONCATENATE HELP . EXE , HELP . MLB HELP. SAM© 



Make sure that the file HELP.MLB that you create is also on the system 
volume. You can back up HELP.EXE and HELP.TXT on another volume 
and delete them from the system volume. Then, to invoke HELP, type: 

( HELPED 

If you leave HELP.MLB separate, you can alter it more easily in the future. 
However, if HELP.MLB is a separate file, the program runs more slowly. 
This problem is significant on systems that use a small device (for example, 
diskette or DECtape II) as the system device. 

DIGITAL recommends that you merge the two files, since the program runs 
faster that way. Use the following command to merge the program and text 
library file or files. 

COPY HELP. (EXE + MLB) HELP. SAVED 



In this case too, you can back up HELP.EXE and HELP.TXT on another 
volume and delete them from the system volume. You can also delete the 
file HELP.MLB, since you can recreate it from the file HELP.TXT. 
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2.7.15 Preventing Fatal System Errors from Causing a Reset 

Normally, the monitor performs a hard reset when a fatal system error 
occurs. The reset stops I/O transfers, minimizing the possibility that the 
error will corrupt media. In some cases, the cause of software errors might 
still be in memory, and the reset preserves the data, making it possible to 
analyze the error. 

However, in rare cases, the reset may prevent diagnosis of hardware errors. 
If you prefer to suppress the reset, you can install the following change in 
the monitor, although doing so increases the risk of corrupting media. 
DIGITAL does not recommend using a monitor with this customization 
installed except for diagnostic purposes. Do not use such a monitor for 
normal operations. 

In the customization, monitr.SYS is the name of the FB or XM monitor file 
you want to modify, and FATAL is the value of that symbol from the moni- 
tor link map. 

, RUN SIPPSH) 
* won it r.SYSffl) 
Base? 0(H) 

Offset? FATAL© 

Base Offset Old New? 

000000 FATAL 000005 240(H) 



000000 FATAL + 2 010127 (CTRl/Y ) (RET) 



* (CTRl/c) 



2.7.16 Running RT-11 in Less Memory Than Is Available 

If your application requires that RT-11 run in less memory than is avail- 
able, you can make a customization that allows you to bootstrap the system 
to run in the lower 12K words or 8K words of a 16K word machine. The BL, 
SJ, and FB monitors have bootstraps that allow the system to run in less 
memory than is available. (This cannot be done for XM monitors, because 
the XM monitor requires 32K memory.) The distributed monitors auto- 
matically make use of all available memory, since most applications re- 
) quire that RT-11 do so. However, if your configuration includes a hardware 

switch register and your application requires less memory, you can make 
the following customization. In the customization, monitr.SYS is the name 
of the monitor file that you want to modify, and BHALT is the value of that 
symbol from the monitor link map. 

, RUN SIPPffiD 
# monit r.SYSiS) 
Base? 0© 

Offset? BHALTEE) 

Base Offset Old New? 

000000 BHALT 000405 0(E) 



000000 BHALT + 2 013704 (CTRL/Y ) (ret) 



* iCTRL/C] 



If this is the hardware bootable monitor, you must write a new system 
bootstrap with the COPY/BOOT command after you install this change. 
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Once you make the change to your monitor, a halt occurs whenever you 
boot that monitor file. While the system is halted, set the switch register to 
one of the values from the following table and press the CONTINUE 
switch; the bootstrap operation then completes for the memory size you 
specify. 



Value 


Size in Words 


40000 


8K 


44000 


9K 


50000 


10K 


54000 


UK 


60000 


12K 


64000 


13K 


70000 


14K 


74000 


15K 


100000 


16K 


104000 


17K 


110000 


18K 


114000 


19K 


120000 


20K 


124000 


21K 


130000 


22K 


134000 


23K 


140000 


24K 


144000 


25K 


150000 


26K 


154000 


27K 



If your configuration does not include a hardware switch register or if you 
always want the system to boot in a specified amount of memory without 
halting, you can make the following customization. In the customization, 
monitr.SYS is the name of the monitor file that you want to modify, and 
nnnnnn is a value from the preceding table. 

, RUN SIPP® , 

*Monit r.SYS® > 

Base? 



Offset? BHALT® 

Base Offset Old New? 

000000 BHALT 000405 240® 

000000 BHALT 013704 12704® 

000000 BHALT 177570 nnnn nn(E 

000000 BHALT 042704 • SE® 
* JCTRL/C) 



If this is the hardware bootable monitor, write a new system bootstrap with 
the COPY/BOOT command. Once you change your monitor, the system will 
boot in the memory you specify whenever you boot the customized monitor 
file. 

To run RT-11 in exactly 28K words, use the customization in Section 
2.7.21. 
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2.7.17 Setting VTCOM Default Dial String 

Apply the following customization to VTCOM.REL or VTCOM.SAV to set a 
default dial string for the DIAL command. 

In the customization, the symbol ..DIAL represents the address of the first 
character in the dial string, which is dictated by your modem. For example, 
the first character required in a dial string sent to a DF03 modem is "B. The 
next 39(decimal) bytes are reserved for the remainder of the dial string, 
including other characters your modem may require. You can find the cor- 
rect value for the symbol ..DIAL in the file CUSTOM.TXT on your distribu- 
tion kit. Replace the symbols aaa, bbb, and so on, with the characters that 
make up your dial string. Use a null character in the last byte to terminate 
the dial string. 

To modify VTCOM.REL: 

.R SIPP© 
* VTCOM.REL© 
Base? 0© 
Offset? ..DIAL© 

Base Offset Old New? 
..DIAL 02 \ © 

Base Offset Old New? 

00 ..DIAL . 2 © 

000000 ..DIAL+1 xxx aaa© 

000000 ..DIAL + 2 xxx bbb© 



000000 ..DIAL + 51 xxx CTL/y H ret) 



* Ctrl;c) 



2.7.18 Setting Upper Limit on a File Size 

If your application requires an upper limit on the size of a file, you can 
install a customization that changes the maximum size RT-11 allocates in 
a general .ENTER request. On distributed monitors, the .ENTER pro- 
grammed request allocates space in such a way that the maximum size of a 
file is either half the largest space available or the entire second largest 
space available, whichever is larger. For most applications, this scheme is 
satisfactory and should be left unchanged. However, if yours is an applica- 
tion that requires an upper limit, you should make the following change. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, $RMON is the value of that symbol from the monitor link 
map, and nnnnnn is the octal number of blocks that is to be the maximum 
file size for a general .ENTER. 



.RUN SIPPS 
*Mon i t r . S\ 
Base? 
Offset? 

Base 
$RM0N 


w 

fS© 
SRMON© 
314© 

Offset 
0314 
3 1 B 


Old 
177777 

X X X X X X 


New? 
rirmnrml 


$RM0N 
*(cm/c) 


(CTRL/Y KRET) 
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2.7.19 Specifying 50-Cycle Instead of 60-Cycle Clock Rate 

You can modify the monitor so that it causes the TIME command to base 
calculations on a 50-cycle clock rate rather than a 60-cycle rate, which is 
the standard rate in RT-11. The 50-cycle clock has specialized uses and is 
the common frequency in Europe. To alter the rate, you must modify the 
monitor so that bit 5 is set in the monitor configuration word. This custom- 
ization has no effect on Professional 300 series processors. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, $RMON is the value of that symbol from the monitor link 
map, and the new value that you enter is the sum of the old value displayed 
by SIPP plus 40 (octal). 



.RUN SIPP® 
*m on it r .SYS®) 
Base? $RM0N® 
Offset? 300®) 

Base Offset 
$RM0N 00 0300 


Old 
n n n n n n 



New? 

i-inriririri + 40®) (You must add 40 


*RM0N 000302 


(CTRL/Y HRET) 



* (CTRL/C] 



2.7.20 Using CAPS-11 to Load Files 

If you use CAPS-11 to load RT-11 files, you must modify the cassette 
handler. CAPS-11 cassette file headers differ from RT-11 cassette file 
headers, so that problems occur when you transfer files to cassette. When 
you load files with the CAPS-11 CABLDR or with the CTLOAD bootstrap, 
CABLDR and CTLOAD interpret the level byte in the file header as a 
header continuation byte. If the byte in the cassette header is nonzero, 
CAPS-11 ignores at least the first data record of the file, since it assumes 
that the record is an auxiliary header record. To avoid losing any data 
records, you must modify CT.SYS so that all header records contain a level 
byte of 0. 

,RUN SIPP® 
*CT,SYS® 
Base? 1000® 

Offset? 3463® 

Base Offset Old New? 

001000 0034G3 001 0® 



001000 0034G4 040 I ctrl/y )® 



■ MCTRL/C) 



If you need to use the system generation process to build your own system, 
you can edit CT.MAC. Use any editor to create a file CT.SLP as follows. 
Use SLP to edit CT.MAC. 



\ 

-/LEVEL: / » . 
LEVEL zIBl.BYTEOO 
/ 
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2.7.21 Setting Upper Limit on Memory Size 

If your PDP-11 does not generate a bus timeout trap, when the running 
program accesses location 160000, the RT-11 bootstrap may assume that 
you have an LSI-11 with the MSV11-DD memory option. The bootstrap 
assumes that there are 30K words available for the operating system. If 
this is not the case, RT-11 will not load into memory properly. However, if 
you install the following customization in your monitor, the bootstrap will 
never look for more than 28K words of memory. You cannot install this 
customization in an XM monitor. In the customization, monitr.SYS is the 
name of the monitor file that you want to modify. 

< RUN SIPPED 
*monit r.SYSdD 
Base? lOOOffl) 
Offset? BO© 

Base Offset Old New? 

1 GO 17 1 e (® 

001000 0000G2 001402 (CTRUyX ret) 
* (CTRL/C) 



If the monitor you modify is the hardware bootable monitor, write a new 
system bootstrap with the COPY/BOOT command. 

2.7.22 Suppressing the Bootstrap Message 

If you want to prevent the monitor identification message from printing 
when you bootstrap a monitor, you can modify that monitor. In the custom- 
ization, monitr.SYS is the name of the monitor file that you want to modify, 
and ..SLNT is the value of that symbol from the monitor link map. 



• RUN SIPF 

* m o n i t r . S \ 
Base? OEH) 
Offset? ..SLNTEE) 

7 Base Offset Old New' 



00 . , S L N T 1 © 

00 , , S L N T + 2 1 3 (5trI7T) (ret) 



* (CTRL/C) 



If the monitor you modify is the hardware bootable monitor, write a new 
system bootstrap with the COPY/BOOT command. 

2.7.23 Suppressing the Start-Up Indirect Command File 

If you want to prevent the start-up command file from executing when you 
bootstrap a monitor, you can modify that monitor. The standard monitors 
include start-up indirect command file support although you need not select 
it if you perform the system generation process to create special monitors. 
In the customization, monitr.SYS is the name of the monitor file that you 
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want to modify, and ..NIND is the value of that symbol from the monitor 
link map. 

,RUN SIPPdD 
*moni t r.SYSdD 
Base? 0© 
Offset? ..NIND© 

Base Offset Old New? 
00 ..NIND 4 '-' ^~~ 



ft tCTRL/C) 



00 . . N I N D + 2 H 4 



[CTRL/Y ) (RET) 



If the monitor you modify is the hardware bootable monitor, write a new 
system bootstrap with the COPY/BOOT command. 

2.7.24 Suppressing the Start-Up Indirect Command File Echo 

If you want the start-up indirect command file to execute when you boot- 
strap a monitor but you do not want the command lines in the file to echo 
(appear) on the terminal, you can modify the monitor. This customization 
causes the monitor to use the SET TT QUIET mode of operation. In the 
customization, monitr.SYS is the name of the monitor file that you want to 
modify, and ..TTQU is the value of that symbol from the monitor link map. 

,RUN SIPPE) 
#moni t r. SYS(© 

Base? 0® _ 
Offset? • .TTOUfiB 

Base Offset Old Neu? 

1© 



X (CTRL/C) 



00 . . T T U 

000000 ..TTQU+2 001403 EBEZXHD 



If the monitor you modify is the hardware bootable monitor, write a new 
system bootstrap with the COPY/BOOT command. 

2.7.25 Changing the Bootstrap Message 

If you want to change the monitor identification message that appears 
when you bootstrap a monitor, you can modify that monitor. Run SIPP to 
modify the monitor file. Place the string (the message) in the monitor im- 
age starting at location BSTRNG. End the string with a null byte. The 
string must not be more than 20(decimal) bytes long, including the null 
byte. If the monitor you modify is the hardware bootable monitor, write a 
new system bootstrap with the COPY/BOOT command. 

2.7.26 Changing the Default Device for Indirect Command Files 

If you want to change the default device for indirect command files, you can 
modify the monitor. Normally, when you invoke an indirect command file 
(by typing (afilnam), the default device where the monitor looks for the 
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command file is DK:. If you have a special application, you can change this 
default to any three-character device name. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..ATDK is the value of that symbol from the monitor link 
map, and nnn is the new default device name. 

, RUN SIPP® 

* won it r.SYStH) 
Base? OdD 
Offset? . . ATDKdD 

Base Offset Old New? 

000000 ..ATDK 015270 iR®) 

000000 ..ATDK <DK > iRnnnlH 

00 . . A T D K + 2 < A W 1 > (CTRL/y I fRFfl 

♦ StrjJcD 



2.7.27 Changing the Default File Type for Indirect Command Files 

If you want to change the default file type for indirect command files, you 
can modify the monitor. Normally, indirect command files have the default 
file type .COM. When you invoke an indirect command file (by typing (a fil- 
nam), the monitor looks for the file filnam.COM. If you have a special 
application, you can change this default to any three-character file type. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..ATFX is the value of that symbol from the monitor link 
map, and nnn is the new default file type. 

, RUN SIPP(U 
* won it r.SYSESl 
Base? OSH) 
Offset? . .ATFX© 

Base Offset Old New? 
000000 ..ATFX 012445 iR© 
. . A T F X < COM) i R n n n Ml 



} , . A T F X + 2 < x x x > I 5trTJy~) (ret) 

/ * (CTRL/C) 



2.7.28 Changing the Default Device for the FRUN Command 

If you want to change the default device for the FRUN command, you can 
modify the monitor. Normally, when you start a foreground program under 
the FB or XM monitor (by typing FRUN filnam), the default device where 
the monitor looks for the program file is DK:. If you have a special applica- 
tion, you can change this default device to any three-character device 
name. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..FRDK is the value of that symbol from the monitor link 
map, and nnn is the new default device name. 
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, RUN SIPPED 
# monit r.SYSED 

Base? Of© 
Offset? ..FRDKIHI 

Base Offset Old New? 
000000 ,.FRDK 015270 'RSI 
000000 ..FRDK <DK > iRnnnd 







..FRDK + 2 <xkx> (CTBL/Y )tm 



(CTRL/C) 



2.7.29 Changing the Default File Type for the FRUN Command 

When you start a foreground program under the FB or XM monitor (by 
typing FRUN filnam), the default file type for the program file is .REL. If 
you have a special application, you can change this default file type to any 
three-character file type. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..FRUX is the value of that symbol from the monitor link 
map, and nnn is the new default file type. 



( RUN SlPPdH 
* monit r.SYSE) 
Base? 0© 
Offset? ..FRUX® 

Base Offset 
000000 . .FRUX 
. . F R U X 
OOOOOO , , FRUX +2 


Old 

070524 

<REL> 

<ANG> 


New? 
RdB 

jRnnn® 

(CTRL/Y KRET) 


„ (CTRL/C] 





2.7.30 Changing the Default Device for the EDIT Command 

If you want to change the default device for the EDIT command, you can 
modify the monitor. Normally, when you invoke an editor by typing the 
EDIT command, the default device where the monitor looks for EDIT.SAV 
is SY:. If you have a special application, you can change this default device 
to any three-character device name. The customization changes the default 
device for EDIT only; it does not change the default device for KED or K52. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..EDDV is the value of that symbol from the monitor link 
map, and nnn is the new default device name. 



, RUN SIPPiLD 
* won it r .SYSd!) 

Basp' ° m 
Offsets . .EDDY© 

Base Offset 
i i E D D V 
. . E D D U 
, , E D D K> + 2 


Old 

07525 

<SY > 

<CHU> 


New? 

;r(H) 

i R n n i" 

(CTRL/Y Iff 


„(CTRL;c) 
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2.7.31 Changing the Default File Name for the EDIT Command 

If you want the monitor to run a program other than the default editor 
when you type the EDIT command, you can modify the monitor to change 
the default file name. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, PROGDF is the value of that symbol from the monitor link 
map, and EEE is 200 (octal) plus the new byte value of one of the following 
symbols from the monitor link map: 

$$EDIT Command value for default editor EDIT 
$$KED Command value for default editor KED 
$$K52 Command value for default editor K52 

, RUN SlPPdH) 
* mo nit r .SYSdD 
Base? OdB 
Offset? PROGDFdD 

Base Offset Old New? 
000000 PROGDF 103225 \© 

Base Offset Old New? 
000000 PROGDF 225 EEE© 
000000 PROGDF+1 206 CTRL/Y ) (reD 



*@BDcJ 



2.7.32 Using Examine and Deposit Above the Background Job 

If you want to be able to examine and modify the monitor and the I/O page, 
you can modify the monitor to remove a restriction on the use of the E 
(Examine) and the D (Deposit) keyboard commands. Normally, the monitor 
allows you to examine and modify only locations inside the background 
job's area. You can remove this restriction, but you must be extremely 
careful when modifying the monitor or I/O page, since you may inadver- 
tently destroy the resident monitor or corrupt a device. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, and ..EMON is the value of that symbol from the monitor 
link map. 

, RUN SIPPdB 
# mo nit r.SYSdD 
Base? 0(SB) 

Offset? ..EMONdU 

Base Offset Old New? 

000000 . ,EM0N 103041 240(13 



000000 ..EMON + 2 103007 (CTRL/Y ) (ret) 



* (CTBL/c ) 



2.7.33 Changing the Default Device for QUEMAN 

You can change the default device for the queue manager (QUEMAN). 
Normally, when you use the PRINT or DELETE/ENTRY command (in an 
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FB or XM system with QUEUE running as a foreground or system job) 
QUEMAN sends the file to the device LP: or deletes the entry from the LP: 
queue. If you frequently queue to another device (such as the serial printer, 
LS:), you can change the default device for these commands. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, ..QULP is the value of that symbol from the monitor link 
map, and dv is the two-character device name that you want as the default. 

.RUN SIPPdD 
*monitP.SYS@B) 
Base? 0© 

Offset? , .QULPED 

Base Offset Old New? 

00 , , U L P 050114 i AtES) 

..QULP < L > ; AddH) 

00 , . U L P + 1 < P > 5 A u (Ml 

00 . . U L P + 2 < : > CTRL/Y K HeD 
* [CTRL/c) 



2.7.34 Changing the Indirect Command File Nesting Depth 

You can increase the indirect command file nesting depth. Normally, 
RT-11 allows you to nest indirect files to a depth of three. A nesting depth 
of three allows your indirect file to invoke another indirect file, which 
invokes still another indirect file. If you have a special application that 
requires more nesting, you can change the maximum nesting depth by 
modifying the monitor. Note that if you increase the nesting depth, any use 
of the indirect file feature will use more memory than is usual. 

In the customization, monitr.SYS is the name of the monitor file that you 
want to modify, $RMON is the value of that symbol from the monitor link 
map, and nnn is the maximum indirect file nesting depth that you want; 
nnn should be a small integer, and must not be zero. 



.RUN SlPPdH 
*monit r .SYSdH 
Base? $RM0N(H> 
Offset? 377(1!) 

Base Offset 
$RM0N 000377 


Old 
3 

XXX 


New? 
nnndB 


$RM0N 000400 


(CTRL/Y ](RET) 


#(CTRL/c] 





2.7.35 Changing the Threshold for Resuming Output-Stalled Jobs 

You can improve FB or XM system throughput by changing the threshold 
for resuming output- stalled jobs. In an RT-11 FB or XM system, a job is 
placed in a stalled state whenever it has terminal output to print but there 
is no room in its terminal output ring buffer. The system restarts the job 
when room becomes available in that ring buffer. The system's default 
mode of operation is to restart the job as soon as a single character of space 
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; 



is available. If more than one job is running, this mode of operation can 
cause the system to spend much time swapping in the context of a job, 
simply to have it output a single character and then stall again. 

You can patch the monitor so that a job that is stalled waiting for room in 
the terminal output buffer does not resume execution until several charac- 
ters are available in the ring buffer. If you have a foreground or system job 
that produces a large amount of terminal output, installing this change can 
greatly improve system throughput. 

In the following customization, monitr.SYS is the name of the monitor file 
that you want to modify, ..TTON is the value of that symbol from the 
monitor link map, and nnn is the threshold value for resuming a terminal 
output stalled job. 

The monitor will resume such a job when there are nnn-1 characters left to 
print in the output ring. The default value, 50 (octal), is the size of the ring;' 
consequently, the monitor resumes a job when 47 (octal) characters are left 
to print (that is, when only one character position is available in the output 
ring). You can specify any value from 1 to the size of the output ring buffer 
(which is normally octal 50, but can be changed at system generation time). 
Note that a value of 1 will cause the job to stay stalled until its ring buffer 
is empty, and may cause terminal output to appear unaligned. 

• RUN SlPPdS 
*moni t r.SYS(H) 
Base? o(© 
Offset? ..TTONdSl 

Base Offset Old New? 
00 ..TTON 5 



000000 ..TTON+2 xxxxxx 



•E jCTRL/C) 



n n n IBID 
CTBL/Y K flff) 



2.7.36 Changing the Default Number of Directory Segments 

\ You can change the number of directory segments DUP creates when you 



initialize a volume. Normally, DUP uses the default number of directory 
segments, which depends on the size of the volume. (Refer to the RT-11 
System Utilities Manual.) In other words, when you use the INITIALIZE 
command to initialize a volume, DUP ascertains the size of the volume and 
checks a table (within DUP) to establish the number of directory segments 
to use. This table consists of two-word entries that give a size and the 
number of segments. DUP searches the table until it finds a size larger 
than or equal to the size of the volume being initialized and uses the value 
in the following word as the number of directory segments. 

If the default number of directory segments for a volume is unacceptable for 
your application, you can use the /SEGMENTSm option with INITIALIZE 
to initialize a volume with n directory segments. (Refer to the RT-11 Sys- 
tem User's Guide.) However, if you want DUP to use a specific number, 
you can modify DUP to change DUP's directory segment table (duplicated 
in the following). 
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.WORD 


1 


.WORD 


1 


.WORD 


4 


.WORD 


4 


• WORD 


3 


.WORD 


20 


.WORD 


177777 


.WORD 


37 


.BLKW 


10, 


.WORD 






',' o 1 u m e s with < 
Set 1 s e 3 iii e n t 
o 1 u iii e s with •■ 
Set 4 segment 
K> o 1 u m e s with ■■ 



= 512. blocks 
d i rectories 
= 2048. blocks 
directories 
= 12288. blocks 

Set IB. segments 

V o 1 u m e s with < = G 5 5 3 5 . blocks 

Set 31. segments 

Expansion space for finer variations 

Must be . 



In the customization, nnnnnn is an octal offset value from the table below. 
The value mmmmmm is an octal number (in the range 1 to 37) for the 
number of directory segments you want as the default. Find the size of the 
volume for which you are changing the default number of directory seg- 
ments in the table. Enter the corresponding offset value in nnnnnn. Then, 
enter the number of default directory segments you want in mmmmmm. 



Size of Volume (Blocks) 
(decimal) 

< = 512 

< = 2048 

< = 12288 

< = 65535 



Offset Value 
(octal) 

000002 

000006 

000012 

000016 



,R SIPP® 

*DUP.SAO® 

Se anient? 10® 

Base? SEGTBL® 

Offset? nnininnO 



S e S iii e n t 

1 
1 



Base 
SEGTBL 
SEGTBL 



Offset 
n n n n n n 
n n n n n n + 2 



Old 

< X X X X X X > 

< X X X X X X > 



New? 

mm mm hi in (HD 

(CTBL/YK RJT) 



2.7.37 Changing the Banner Page Width 

You can modify QUEUE to change the width of the banner page on line 
printer output from 132 positions to 80 positions. 

In the customization, ..NBl, ..NB2, and ..NB3 are the values of those sym- 
bols from the link map. 



.RUN SIPP® 








*QUEUE.REL/A® 








Base? 0® 








Offset? ..NBl® 






Base 


Offset 


Old 


New? 





. .NBl 


j 79 


15® 





. .NB1+1 


124 


12® 





. .NBl+2 
. .NBl+3 


055 
0B1 


0® 





(CTHL/2 ](RET) 
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Offset' 



. .NB2@B) 



Base Offset 
. . N B 2 
00 . . N B 2 + 2 



Offset? 



. .NB3dB 



*(CTRL/C 



Base Offset 

000000 . . NB3 

00 . . N B 2 + 2 

j 



Old 
2 U 
0G450S 



Old 

1 1002a 

07GB 



New? 

5015(H) 
(CTRL/z K RETl 



New? 

240(H) 

(ctrl/yH ret) 



2.7.38 Modifying Listing Page Length in LINK 

If you do not use line printer paper of a standard size (10.5 inches long) or if 
your configuration does not include a line printer, you may need to modify 
the listing page length in LINK. RT-11 LINK sets the number of lines 
printed on each listing page at 60. This line count is generally satisfactory 
only for applications with line printers that use paper 10.5 inches long. 
However, you may require a listing of a different length. In the customiza- 
tion, LINPPG is the value of that symbol in the link map, and nnn is the 
desired listing page length (in lines). 



. RUN SIPPdB 
*LINK.SAy@) 
Se anient? 0®) 
Base? 0(H) 

Offset? LINPPGdB 



Se Jme n 1 





* ICTRL/C) 



Base 





Offset 
LINPPG 
LINPPG+2 



Old New? 
? ri n n <i 



(ctrl/y) (ret) 



2.7.39 Assigning the HELP File 

If you want to assign your HELP file to a file and/or device other than 
SY:HELP.SAV, you can modify the monitor. 

In the customization, monitr.SYS is the name of the monitor file that you 
wish to modify, and ..HELF is the value of that symbol from the monitor 
link map. The RAD50 file specification starts at ..HELF. 



• RUN SIPPdD 

* won it r .SYS 
Base? 0(H) 
Offset? ,,HELF(H) 



Base 









Offset 
.HELF 
.HELF 
.HELF+2 
.HELF+4 
.HELF+G 
.HELF+10 



Old 
075250 
<SY > 
<HEL> 
<P 

<SAU> 
< xxx > 



New? 

iR(H) 
iRdevlH 
iRf il(H 
!Rnain(H 
iRex tEB 

[CTRL/Y) (RET) 



* (CTRL/C) 
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2.7.40 Changing the Device from Which IND.SAV is Run 

By default, the system runs IND.SAV from SY: when KMON is set to IND 
and you type @IND. You can modify the monitor to change the device from 
which the IND.SAV file is run. To change the device, change the contents 
of ..INDN to the RAD50 device name of the device from which IND will be 
run. For example, to run IND from the virtual device (VM), open the 
..INDN location in the link map and change its contents to VM. 

In the customization, monitr.SYS is the name of the monitor file that you 
wish to modify, and ..INDN is the value of that symbol from the monitor 
link map. 



, RUN SIPPdJ) 
* won it r.SYSIIB 

Base? om 

Offset? ..INDNdU 






Base 

U 



Offset 
, , INDN 
, . INDN 
, . INDN+2 


Old 
075250 
<SY > 
<IND> 


New? 
iRifi) 
iRde yES) 

(CTRL/ Y) (RET) 



# (CTRJ7CJ 



2.7.41 Supporting Bad Block Replacement in User-Written 
Handlers 

If a user- written handler supports bad block replacement, one of the follow- 
ing customizations must be applied. If all bad blocks are replaceable (such 
as the RL01/02), apply customization A. If only bad sector errors are re- 
placeable (such as the RK06/07), apply customization B. 

Customization A 

. R SIPP© 
DUP.SAOdl) 

i e $ in ( 
Base' 



S e 3 in e n t ? * ' 



Offset' 



ARDPS© 



Segment Base Offset Old New 

1 3 

0000 1 3 
A (CTRL/ c ) 



ARDPS 000 377© 

ARDPS+1 000 ( CWY )(Bn) 



Customization B 

, R SIPP© 
*DUP.SAM(H) 
Segment? 1® 
Base? 0® 
Offset? SRDPStH) 

Segment Base Offset Old New' 
000001 000000 SRDPS 000000 \© 
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S e S m e n t 


Base 


Offset 


Old 


New? 


1 





BRDPS 





377© 


1 





SRDPS+1 





(CTRL/Y)(RET) 


* (CTRL/C) 











2.7.42 Supporting User-Written Magtape Handlers 

If a user-written magtape handler is used, the following three customiza- 
tions must be made. All three customizations assume that the device code 
for the device is 377 (octal). 

Customization 1 



, R SIPP© 








* DUP.SAOtE 








Se anient? 1(E) 








Base? 


0(E) 








Offset? 


MTDPSSD 






Serine n t 


Base 


Offset 


Old 


New? 


1 





MTDPS 





\®D 


B e $ rti e n t 


Base 


Offset 


Old 


New? 


1 





MTDPS 





377(E) 


1 





MTDPS+1 





(CTRL/Y )(RET) 


* (CTRL/C] 











Customization 2 

, R SIPP(E) 

* PIP,SAU(E) 
Segment? 1(E) 
Base? 0(E 
Offset? PIPMTtE) 

Segment Base Offset Old New? 

1 P I P M T \ (E 

Se anient Base Offset Old New? 

1 P I P M T 3 7 7 (SB 

/ 1 P I P M T + 1 00 CTRL/Y ) (R£D 

* (cWc~) 



Customization 3 

, R SIPP(E 
*MDUP. SAV® 
Base? 0(E) 

Offset? MDUPMTIE) 





Base 


Offset 


Old 


New? 







MDUPMT 





\(E) 




Base 


Offset 


Old 


New? 







MDUPMT 





377© 







MDUPMT+1 





(CTRL/YKRET) 


(CTRL/C) 
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2.7.43 Replacing Magtape Bootstrap in DISMT1.COM 

Module MB0T16.B0T is a primary bootstrap for producing a 1600 bits/in, 
phase-encoded, bootable magtape. It is usable on either MS or MM drives. 
To use this bootstrap, edit DISMT1.COM by replacing MBOOT.BOT with 
MBOT16.BOT in the INITIALIZE command line. This line should then 
read INITIALIZE/NOQUERY/VOLUMEID/FILE:DIS:MBOT16.BOT TAP:. 

2.7.44 Changing Default File Type of Logical Disk Files 

By default, the file type of logical disk files is .DSK. You can alter the 
default file type in one of two ways. (Note that the same procedures also 
apply to LDX.SYS for the XM monitor.) 

Customization 1 

Edit the conditional file SYSGEN.CND and add the following line: 

D E F * L D = '" R t y p i define default for LD f i 1 e t v p e 

where typ is the desired default file type. Then, reassemble and relink 
LD.SYS using the conditional file SYSGEN.CND. 

Customization 2 

.UNPROTECT SY:LD.SYS(BH) 
,R SlPPdH 
*SY:LD.SYS/Adl) 
Base' . .LDEXtH) 
Offset? 0(H) 



Base Offset 


Old 


New? 





.LDEX 


7 T* 7 'T* 7 ^ 


;r(H) 





,LDEX 


<DSK> 


iRt'/p© 


(.) (J i.) (J V U 


.LDEX+2 


<DSK> 


iRtypfH) 





.LDEX+4 


<DSK> 


;Rtyp(Hl 





.LDEX+G 


<DSK> 


iRtyp(H) 


f ) 


.LDEX+10 


777'p'p'? 


(CTRL; Y )(RET) 



j gTRL'Cl 



2.7.45 Changing QUEUE to Allow First Form Feed 

QUEUE suppresses the first form feed in a file, because QUEUE assumes 
that the LP or LS handler is set to FORMO, which generates a form feed. If 
the line printer handler is set to NOFORMO, no form feed is generated. 

You can apply the following customization so that QUEUE will never sup- 
press the initial form feed in a file. If you apply this customization and set 
your printer handler to FORMO, an extra blank page will be produced. 

In the customization, ..DOFF is the value of that symbol from the file 
CUSTOM.TXT on your distribution kit. 

.RUN SIPPElD 
*OUEUE.REL@S) 
Base? 0© 
Offset? ..DOFF®) 
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# (ctrucT) 



Base Offset Old New? 

OOOOOO ..DOFF xxxxxx 240© 

000000 ..DOFF + 2 xxxxxx 240® 

OOOOOO ..DOFF+4 xxxxxx (ctrT7y~) (ret1 



2.7.46 Changing Listing Page Length in MACRO and CREF 

The default listing page size for MACRO and CREF, 60 lines long, is suit- 
able for line printers that use standard size line printer paper (10.5 inches 
long). If you use line printer paper that is not standard size, or if your 
configuration does not include a line printer, you may need to modify the 
listing page length in MACRO and CREF. In the customizations, nnn rep- 
resents the desired listing page length (octal). Substitute for the symbol 
PGSIZE the value of that symbol given in the file CUSTOM.TXT on your 
distribution kit. 

To modify MACRO: 

. RUN SIPPdD 

* MACRO. SAUdB. 
SeSmen t? 0© 
Base? 0© 
Offset? PGSIZEfH) 

Segment Base Offset Old New? 

000000 OOOOOO PGSIZE 000074 nnnffl) 

OOOOOO 00 0000 PGSIZE + 2 0034S7 (CTRL/y ) (ret) 

* (CTRL/C) 



To modify CREF: 

. RUN SIPP© 
* CREF. SAM© 
Base? 0(H) 
Offset? PGSIZEfH) 

) Base Offset Old New? 

J 000000 PGSIZE 000074 nnn® 

000000 PGSIZE + 2 0034G7 (CTRL/y) (ret) 



* (CTRL/C) 



2.7.47 Changing Default Command File Processor to IND 

In the distributed monitors, the default command file processor is KMON. 
Apply the following customization to change the default command file pro- 
cessor to IND. After you have applied this customization, you may use an 
IND control file as your start-up command file, providing the file IND.SAV 
resides on your system volume. 

In the customization, monitr.SYS is the monitor file you want to modify, 
and ..INDR is the value of that symbol from the appropriate monitor link 
map. If the monitor you customize is hardware bootable, write a new sys- 
tem bootstrap with the COPY/BOOT command. 
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.RUN SIPP® 






♦wonitr.sys® 






Base? 0© 






Offset? ..INDRdS 






Base Offset 


Old 


New? 


00 . 4 I N D R 





1© 


a 00 . . I N D R + 2 


001403 


(CTRL/Y KRED 


*CTRL/C) 





If you do not wish to apply this customization, you can set the default 
command file processor to IND by setting the conditional IND$ON to 1 in 
the conditional file. 

2.7.48 Limiting Amount of Memory KEX Requests 

KEX, by default, requests all available 16-bit memory up to 32KW. This 
customization allows you to limit the amount of memory KEX requests 
with a .SETTOP programmed request. 

In the customization, the symbol ..MAXM represents the highest address 
KEX will request. (In the distributed monitors, this value is set to 177776, 
the highest address possible.) If you set this value too low, KEX will fail 
and print the error message ?KEX-F-Insufficient memory. You can find 
the correct value for the symbol ..MAXM in the file CUSTOM.TXT on your 
distribution kit. Replace the symbol nnnnnn with the new maximum ad- 
dress value you want KEX to request. 



,R SIPP© 






♦KEX.SAOSH) 






Segment? © 






Base? © 






Offset? ..MAXM© 






Base Offset 


Old 


New? 


..MA X M 


XXXXXX 
XXXXXX 


! n n n n n n 


. . M A X M + 2 


(EtruTKrIt) 



■». (CtrT7c~1 



2.7.49 Changing MACRO'S Default .LIST/.NLIST Options 

MACRO-11/RT is distributed with the following .NLIST defaults: 

.NLIST LD,ME,MEB,TTM 

You may change the .NLIST defaults to any of the following, where the 
following bit significance applies (bit asserted implies ".NLIST"): 

BEX = 2 

BIN = 4 
CND = 10 
COM = 20 
LD = 40 
LOC = 100 
MC = 200 
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MD - 400 






ME - 1000 






MEB - 2000 






SEQ = 4000 






SRC = 10000 






SYM = 20000 






TOC = 40000 






TTM = 100000 






. RUN SlPPdUl 






* MACRO. SAVdS 






Segment? (SB 






Base? 0© 






Offset? LCBITSf® 






Base Offset 


Old 


New? 


00 L C B I T S 


1 3 4 


n n ii n n n 


00 L C B I T S + 2 


X X X X X X 


fCTRL/Y MRETJ 


*CTRL/C) 





2.7.50 Changing MACRO'S Default .ENABLE/.DISABLE Options 

MACRO-11/RT is distributed with the following .DSABL defaults: 

.DSABL ABS,AMA,CDR,DBG,FPT,LCM,LSB,MCL 

You may change the .DSABL defaults to any of the following, where the 
following bit significance applies (bit asserted implies ".DSABL"): 

ABS = 1 

AMA = 2 

CDR = 4 

CRF = 10 

DBG = 20 

FPT = 40 

GBL = 100 

LC = 200 

LCM = 400 

LSB = 1000 

MCL = 2000 

PNC = 4000 

REG = 10000 

Note that the flag must always be set. 



.RUN SIP 
*MACRO. SAVES) 
Segment? @S 
Base? OfiB 
Offset? EDBIT 
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ft ( ctrTc") 



Base Offset Old New? 

00 E D B I T S 3 4 G 7 n n n n n n (E 

000000 EDBITS + 2 xxxxxx (CTRL/y K reTI 



2.7.51 Modifying KED Default File Type 

KED now supports default file types. When editing a file, the default input 
file type is .MAC; the default output file type is the same as the input file 
type. When inspecting a file, the default input file type is .LST. There is no 
default input file type when creating a file. 

To specify a file with no file type, type only the file name and the period 
separating the file name and type (FILNAM.). 

You can modify the default file types with the following software custom- 
ization: 

, R SIPPdD 
* aaa.SAV/A(E) 
Base? 0(E) 

Offset? bbbbbbtE) 

Base Offset Old New? 

000000 bbbbbb xxxxxx !R(E) 

b b b b b b < x x x > ! R c c c (E) 



ftl gfRlTc] 



00 00 bbbbbb + 2 < x x x > gTRW] (E 



In this customization, substitute KED, K52, or KEX for aaa. Substitute the 
value for the symbol ..EEXT (for the editing-file default) or ..IEXT (for the 
inspecting-file default) for bbbbbb. These values can be found in CUS- 
TOM. TXT on your distribution kit (be sure to use the proper KED variant). 
Substitute the three-character file type default you want for ccc. 

2.7.52 Changing SPOOL'S Work File Size 

SPOOL allocates by default 1024(decimal) blocks on SFD: or SY: for its 
work file SPOOL.SYS. You can change the default size of SPOOL.SYS by 
applying the following software customization. In the customization, ..SPSZ 
is the offset for the current number of blocks SPOOL allocates for its work 
file. Substitute for' ..SPSZ the value provided in the file CUSTOM.TXT. 
nnnnnn is the number (octal) of blocks you want SPOOL to allocate for its 
work file, xxxxxx is a number that varies; it is not important for you to 
know this number. 
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, RUN SIPP(® 
* SPOOL. RELdH 
Base? OffiD 

Offset? ..SPSI 



Base Offset Old New? 

OOOOOO ..SPSZ xxxxxx nnnnnn© 

000000 ..SPSZ + 2 xxxxxx [ctri/y ) (ret| 



* (CTRiTcl 



If there is not enough room on the volume for a work file of the default size, 
SPOOL. SYS occupies the largest empty area on the volume. 



2.7.53 Changing SPOOL'S Output Device 

You can change SPOOL'S default output device to any RT-11 non-file- 
structured device by installing the following software customization. In the 
customization, substitute for ..SPSO the value provided in the file CUS- 
TOM.TXT. nnn is the new output device's mnemonic, xxxxxx represents a 
number that varies but is not important for you to know. 

, RUN SIPPdD 
#SP00L.REL/A(H) • 
Base? 0(E) 
Offset? ..SPSOED 

Base Offset Old New? 
000000 . . SPSO xxxxxx 



00 ..SPSO < L P > 5 R n n n (ID 
000000 ..SPSO + Z xxxxxx (CTRL/Y )(fT) 



» (CTRL/C) 



2.7.54 Changing LINK for Default 132-Column Link Map and 
Global Cross-Reference Table 

The following customization patch causes the link map and global cross- 
reference table to default to 132 columns, rather than 80 columns. The 
value of ..WDSZ can be found in CUSTOM.TXT on your distribution kit. 



, RUN SIPP®) 








♦ LINK. SAM© 








Segment? 1© 








Base? 0(U 








Offset? ..WDSZO 








Segment Base 


Offset 


Old 


New? 


1 


. .WDSZ 


3 


0000013© 


1 


. .WDSZ+2 


xxxxxx 


(CTRL/Y HRET] 


*(CTRL/C] 
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Figure 2-2: Installation Worksheet 
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Monitors 

G RT11BL.SYS 
□ RT11SJ.SYS 
D RT11FB.SYS 
D RT11XM.SYS 

System Device Handler 



SIZE IN BLOCKS 



Other Device Handlers 



LJ SWAP. SYS 

Utility Programs 

i.J BATCH.SAV 
I J BINCOM.SAV 
! ] BUP.SAV 
! JCREF.SAV 
: ! DIR.SAV 
' J DUMP.SAV 
; ] DUP.SAV 
:.] EDIT.SAV 
: i ERROUT.SAV 

I FILEX.SAV 
i J FORMAT.SAV 
: } HELP.SAV 
U IND.SAV 
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U KEX.SAV 
; J K52.SAV 
U LIBR.SAV 
Q UNK.SAV 
D MDUP.SAV 
LI PAT.SAV 
U PIP.SAV 
U QUEMAN.SAV 
; IQUEUE.REL 
D RESORC.SAV 
[JSETUP.SAV 
D SIPP.SAV 
D SLP.SAV 
I J SPOOLREL 
D SRCCOM.SAV 
LJ UCL.SAV 
; ] VTCOM.REL 
: ! VTCOM.SAV 

Help Files 

D HELP.SAV 
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D SYSLIB.OBJ 
□ SYSMAC. SMI- 
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n MACRO 



Source Flies 



Other Files 
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System Volume 
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Volume 3 



Volume 4 
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PAGE 
PAGE 
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Chapter 3 

Installing a System Distributed on RX01 to Run on a 
Small Device 



If RT-ll was distributed to you on single-density diskettes, and you intend 
to build a system to run on single-density diskette or DECtape II, perform 
the procedures described in this chapter. 

These procedures cover minor variations that depend on the specific device 
you have (diskette or cartridge). The word "volume" in this chapter refers 
to either diskette or cartridge, whichever is appropriate. 

NOTE 

If your hardware configuration includes a VT100 terminal, 
be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-ll. Never set TT NOP AGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, you will have to perform the steps summarized in 
the following list. Sections 3.1 through 3.10 describe the procedures for 
each step. Figure 3-1 shows the various backup volumes you create when 
you install RT-ll. 

1. Bootstrap the distribution volume. 

2. Preserve the distribution volumes. 

3. Install software updates. 

4. Create the working system from chosen components. 

5. Install the bootstrap on volumes that need to be bootable. 

6. Customize the system. 

7. Compress each volume. 

8. Preserve the working system. 

9. Test the working system. 

10. If appropriate, perform the system generation process. 

3-1 



The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 3-1: Sample Backup Volumes 




BACKUP 
DISKETTES 



WORKING 

SYSTEM 

DISKETTES 



COPY 






BACKUP 
WORKING 
SYSTEM 
DISKETTES 



STORAGE CABINET 



3.1 Bootstrapping the Distribution Volume 

The first procedure you perform when installing RT-11 is to bootstrap the 
distribution volume. 

Begin by making sure that the processor is powered up but not running. 
Insert distribution volume 1 in RX01 Unit 0. For RX01 diskette, the device 
name is DX:. 

Use the hardware bootstrap to boot the volume. (If your configuration does 
not include a hardware bootstrap, see Appendix B for toggle-in software 
bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the volume: 
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RT-1 1FB V05. kx 
.TYPE U5USER.TXT 

RT-1 1 M5,xx 



installation of RT-ii ....(followed by V5USER.TXT message). 



After you boot the system, you can create a start-up file containing any 
commands or sequence of commands that you would normally want to exe- 
cute at the start of each terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can. 
execute it with the (a command, so that the commands it contains become 
effective. 

3.2 Preserving the Distribution Volumes 

The first procedure you perform with the running RT-11 system is to copy 
all the distribution volumes for backup, as a safety measure in case of 
machine failure or human error. 

NOTE 

If your volumes are diskettes, you can ignore instructions to 
write-enable or write-protect a volume. Diskettes are always 
write-enabled. DECtape II provides a write-protect feature, 
but single-density diskette does not. 

Insert a blank volume (write-enabled) in Unit 1. Then use the INITIALIZE 
command to initialize the blank volume (procedure follows). Use the /BAD- 
BLOCKS option with INITIALIZE to cover any bad blocks that may be on 
your volume. If the volume contains bad blocks, the ?DUP-W-Bad blocks 
detected nnnnnn message appears on the terminal. 

NOTE 

DIGITAL recommends that you use only volumes that do not 
have bad blocks when you back up distribution volumes and 
build a working system. To ascertain whether an already 
initialized volume has bad blocks, use the command DIREC- 
TORY/BAD xxn:. You can use volumes with bad blocks later, 
for working or data volumes. However, there is an exception 
to this rule. If your volumes are TU58 tape cartridges, you 
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can use the procedure in Section 2.4.3 when you build your 
working system but not when you back up the distribution 
volumes. The procedure in Section 2.4.3 creates dummy bad 
blocks on cartridges to improve response time. 



( INIT-IALIZE/BADBLOCKS xxl:GB) 

x x 1 : / I n i t i a 1 i z e i Are you sure? Y ® 
?DUP-I-No bad blocks detected xxl: 



There may be a significant delay (as much as 8 minutes) while the system 
scans the volume for bad blocks and creates a new directory. The monitor 
dot appears when this process is complete. 



Now, remove the newly initialized volume and initialize eight additional 
blank volumes, leaving a write-enabled and initialized blank volume in- 
serted in Unit 1. 

The next step in the preservation process is to copy all the files from distri- 
bution volume 1 to the initialized blank volume, which becomes backup 
volume 1. 

As long as the volume you intend to copy is bootable and contains certain 
system utility programs, you can boot RT-11 from that volume and copy 
the files from that volume to another volume in Unit 1. A bootable volume 
has the appropriate monitor file and system device handler and a bootstrap. 
The SQUEEZE/OUTPUT:xxn: command transfers all the files from one 
volume in Unit to another one in Unit 1. At the same time, the command 
consolidates all the empty space at the end of the volume. Distribution 
volume 1 is bootable, but the other volumes in your kit are not bootable 
because they lack the necessary components. Thus, these volumes require a 
different copy procedure. For volume 1, however, the procedure is straight- 
forward. Type the following command, where xx is the physical device 
name. 

SQUEEZE/OUTPUT:xxl : xxO:(H) 



NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: op- 
tion and the COPY command transfer files from one device to 
another. SQUEEZE/OUTPUT:xxn: consolidates free space on 
the device at the same time. The procedures in this manual 
use the command that is most appropriate and most efficient 
for an individual operation. For a better understanding of all 
RT-11 keyboard monitor commands, refer to the RT-11 Sys- 
tem User's Guide. 

There is a delay while the file transfer operation takes place. Then copy the 
bootstrap on the volume. 
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• COPY/BOOT xxl :RT11FB.SYS xxl 



Remove the newly created backup volume from Unit 1, write-pro tect it, and 
label it "Backup RT-11 V05 1". (Use a soft-tipped pen when you label 
diskettes.) 

To copy the remaining distribution volumes, which lack certain system 
components, run RT-11 from distribution volume 1 in Unit 0. 

Then, type: 

, SQUEEZE/ N AIT/OUTPUT: xxl : xx0:(© 

M o u n t o u t p u t u o 1 u hi e in x x 1 : i Co n t i n u e ? 

Insert an initialized blank volume (write-enabled) in Unit 1. 

Yds 

M o u n t i ii p u t u o 1 u m e in x x : i C o n t i n u e ? 

Replace the volume in Unit with distribution volume 2 (write-protected). 

Y®D 

M o u n l svste in u o 1 u m e in x x : i C o n t i n u e ? 

Replace the volume in Unit with distribution volume 1 (write-protected). 

YdS) 



Remove the volume from Unit 1, write-protect it, and label it "Backup 
RT-11 V05 2". 

Again type the command: 

, SQUEEZE/WAIT/OUTPLIT:xxl : xxO:(® 

M o u n t o u t p u t volume in xxl:! Co n t i n u e ? 

Insert another initialized blank volume in Unit 1. 

YdD 

M o u n t i n p u t u o 1 u m e in x x : i C o n t i n u e ? 

Replace the volume in Unit with distribution volume 3 (write-protected). 

Y(ffiD 
M o u n t svste m y o 1 u m e in x x : i C o n t i n u e ? 

Replace the volume in Unit with distribution volume 1 (write-protected). 
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Remove the volume from Unit 1, label it "Backup RT-11 V05 3", write- 
protect it, and insert another initialized blank volume in Unit 1. Repeat 
these procedures to copy the rest of the distribution volumes. 

Now halt the processor. Replace distribution volume 1 with backup volume 
1 (write-protected) in Unit 0. Write-protect the distribution volumes, and 
store them. You will use the backup copies to build a working system. 

Use the hardware bootstrap to boot backup volume 1. 

RT-i 1FB U05, xx 

(Followed by any start-up file commands.) 



NOTE 

If the backup volume does not boot, repeat the procedure to 
create the backup volume. 

Next, remove the protection from all the files on the backup volumes. The 
files on the distribution volumes have been protected to prevent you from 
accidentally deleting them. (Refer to the RT-11 System User's Guide for a 
description of file protection.) When you copied the files to the backup 
volumes, RT-11 also copied the protection (note the P that prints next to 
the file size in the directory). For the rest of these procedures, you need to 
remove the protection from the backup volumes. Type the following com- 
mand to remove it from the files on backup volume 1. The /SYSTEM option 
is required to remove protection from system files (.SYS) if wildcards are 
used in the file specification. 

, UNPRQTECT/SYSTEM * . *(H) 

Files unprotected: 
DK:aaaaaaittt 
DK : bbbbbb . ttt 
DK:ccccccittt 
DK : dddddd . ttt 



DK:zzzzzz.ttt 



Insert backup volume 2 in Unit 1, and type the following command: 

, UNPROTECT/SYSTEM x x 1 : * . *(§CD 

Files unprotected: 
xxl:aaaaaa.ttt 
x x 1 : b b b b b b , 1 1 1 
xxl:cccocc.ttt 
x x 1 : d d d d d d . 1 1 1 



xxl:zzzzzz.ttt 
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Replace backup volume 2 with backup volume 3 in Unit 1 and repeat this 
; command. In the same way, remove protection from the files on the rest of 

the backup volumes. 

3.3 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
\ base system and contain modules for both base system and layered prod- 

ucts. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing an error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

> 3.4 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have 
planned the best arrangement of them on volumes (Section 2.4), you can 
create the working system by copying selected components to initialized, 
blank volumes. 

Start by initializing a number of blank volumes. Follow the same procedure 
that you used in Section 3.2. Insert a write-enabled, blank volume in Unit 1 
) (with the system booted from Unit 0), and type INITIALIZE/BADBLOCKS 

xxl:. Repeat the process to create as many initialized blank volumes as you 
need for the system that you have planned. 

NOTE 

If you want to create dummy bad blocks on cartridges to 
avoid excessive rewinds (as described in Section 2.4.3), do so 
at this point. 

Then, use the COPY command to copy selected files from backup volume 1 
to the volume that becomes your working system volume. The /SYSTEM 
option is required for copying .SYS files only if wildcards are used in the 
input file specification. 

• COPY xxO : f i lnain . f/p x x 1 : f i 1 n am , t y pEH) 
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You can use the following command to avoid typing numerous file specifica- 
tions. 

.COPY/QUERY/SYSTEM xxO: x x 1 : (© 

Files copied: 
xxO:aaaaaa,ttt to xxl:aaaaaa.ttt? Y@lD (to include a specific file! 

x x : b b b b b h . 1 1 1 to x x 1 : b b b b b b . 1 1 1 ? N© (to exclude a specific file) 

(and so on) 

To copy files from nonbootable volumes, alternate volumes. 

Use the SET command to set the USR to NOSWAP. 

. SET USR NOSWAPdS 

Type the following command, where filnam.typ is the name of the file you 
want to copy. In this case, you cannot use the /QUERY option; you must 
specify individual files. 

•COPY/WAIT xxi : f i lnam. typ x xO : f i 1 n am . t y p(H! 
M o u n t i n p u t u o 1 u m e in x x 1 : \ Co n t i n u e ? 

Place the volume containing the file you want to copy in Unit 1. 



M o u n t o u t p li t ijoI u m e in x x : i Co n t i n u e ? 

Replace the system volume in Unit with the volume to which you want to 
copy filnam.typ. 

Y(sH) 

M o li n t s y s t e m u o 1 a m e in x x : i C o n t i n u e ? 

Replace the volume in Unit with backup volume 1 (write-protected). 



Repeat this procedure to copy all the files for the working system volume. 
When you have copied all the files you have planned for the working sys- 
tem volume, label it "RT-11 Working System V05 1". Repeat these proce- 
dures to create the other volumes in the working system. 
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When you have created and labeled all the working system volumes, you 
can permit the USR to swap again. 

.SET USR SWAP®) 

3.5 Installing the Bootstrap on Any Volumes That Need to Be 
Bootable 

Once you have created your system, you need to install the bootstrap on 
any volumes that must be bootable (that is, that you can use as the system 
volume). Generally, any volume that includes a monitor file and system 
device handler should be bootable (but remember that the volume would 
need SWAP.SYS and, for the SJ monitor, TT.SYS). 

Insert in Unit 1 the volume on which you need to install the bootstrap. In . 
the following command, aa is BL, SJ, FB, or XM. 

.COPY/BOOT xxl :RTllaa.SYS x x 1 : (H) 



In this command, you need to identify the device on which the monitor that 
contains the bootstrap information resides, the name of that monitor file, 
and the device on which you need to install the bootstrap. This command 
copies bootstrap information from the monitor file to blocks and 2 through 
5 of the same volume. 

Then, insert working system volume 1 in Unit 0, and use the hardware 
bootstrap to boot your working system. 

RT-i laa U05. xx 

(Followed by any start-up file commands.) 

Store the updated backup volumes for future updating purposes. 



3.6 Customizing the System 



You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 3.10.) 
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3.7 Compressing Each Volume 

DIGITAL recommends that you compress each working system volume to 
make its free space contiguous. Consolidating free space allows you to use 
space on the volume that would otherwise be too fragmented to be usable. 
However, if your volumes are TU58 tape cartridges and you create bad 
blocks to avoid excessive rewinds, the amount of contiguous free space pos- 
sible is limited. (Refer to Section 2.4.3.) 

Continue to run RT-11 from Unit 0, and use the SQUEEZE command to 
compress free space. (The volume must be write-enabled.) The squeeze 
operation does not move files with the .BAD file type. 

.SQUEEZE xxO:® 

x xO : /Sq ue e z e i Are you sure? Y® 

There will be a delay as the system compresses the volume. 

RT-llaa VQ5.00 

(Followed by any start-up file commands.) 

» 

The system automatically reboots when you compress a system volume. 

Then insert the next volume that you need to compress (write-enabled) in 
Unit 1. 

.SQUEEZE xxlsES) 

x x 1 : /Sq Lie e z e i Are you sure? YCrED 

Replace the volume in Unit 1 with the next one you need to compress, and 
repeat this procedure for all the volumes you need to compress. 

NOTE 

When you compress a volume with system files (.SYS), PIP 
warns you to reboot. Do reboot as advised. When you com- 
press a system volume, the system automatically reboots. 

3.8 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files in the working system and preserve the system on 
backup volumes. 

Use the following command to protect all the files on the system volume: 

.PROTECT/SYSTEM * , *W) 

Files protected: 
DK:aaaaaa.ttt 
DK:bbbbbb. ttt 
DK:ccccoc.ttt 
DK : dddddd .ttt 



DK:zzzzzz.ttt 
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To protect files on other volumes in the working system, insert each volume 
in Unit 1 and use the following command: 



.PROTECT/SYSTEM xxl:*.*(RlD 

Files protected: 
xxl:aaaaaa,ttt 
x x 1 : b b b b b b . 1 1 1 
xxl:cccccc.ttt 
x x 1 : d d d d d d . 1 1 1 



xxl:zzzzzz.ttt 



Next, copy the working system to backup volumes. Insert a blank volume 
(write-enabled) in Unit 1 with RT-11 still booted from Unit 0. Use the 
INITIALIZE/BADBLOCKS command to initialize the blank volume. Then, 
repeat the process to initialize the appropriate number of volumes. 

Copy all the files in your working system. You can use the 
SQUEEZE/OUTPUT:xxn: command to copy any bootable volumes. Remem- 
ber that you must use SQUEEZE/WAIT/OUTPUT:xxn: and change vol- 
umes to copy the volumes that are not bootable. (Refer to Section 3.2.) Also 
remember to copy the bootstrap to any volumes that need to be bootable. 

Write-protect the backup working system volumes, and store them. If you 
ever need to restore the working system, you can make copies of the backup 
working system volumes. 

3.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components: 

SWAP.SYS 

RT11FB.SYS 

xx. SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 
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Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 



DIRECTORY/BRIEF/COLUMNS: 1 SY: 

d d - m w Hi - v v 



SWAP 


, SYS 


RT1 1FB 


, SYS 


LP 


.SYS 


DX 


.SYS 


EDIT 


. SAV 


MACRO 


, SAV 


SYSMAC 


.SML 


LINK 


. SAV 


PIP 


.SAM 



xxx Files i bibb BlocKs 
fff Free blocks 



NOTE 



If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s ) to stop the display and 
(ctrl/q) to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 

3.9.1 Preparing the Background Demonstration Program 

3.9.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

. EDIT SYrDEMOBG.MAC© 
*Fi®.ASCII( 
* OAC 
» EXQ 



3.9.1.2 Assemble the Background Demonstration Program — The background 
program, DEMOBG.MAC, is an assembly language source file; it must 
be assembled and linked before you can execute it. To assemble 
DEMOBG.MAC and obtain a listing, make sure that your configuration 
has a line printer that is on-line and ready. 
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ASSIGN LP: LST:( 



NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

. ASSIGN TT: LST:®) 



Assemble DEMOBG.MAC as follows: 

. MACRO/LIST:LST: DEMOBGdD 

(See Figure 3-2.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

. RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC© 



Figure 3-2: DEMOBG Assembly Listing 



DEMOBG MACRO U05.01b Friday O9-0*c-83 10:16 Pag* 1 



000000 
000031 
000042 


000777 


00004 4 
000052 
000106 


000207 


000110 


007 


000112 

000147 


122 
111 


000225 


00 


000226 
000242 


000000 



055 
040 



.TITLE DEMOBG 

.IDENT /V05.Q0/ 
DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE. THEN 
RING BELL IF FG JOB SENAS A MESSAGE. 

.MCALL .RCVDCi .PRINT 



bell: 

msg: 



. RCVDC 

.PRINT 



*AREAF#BUFFER.*400»tMSGIN iPGSl REQUEST FOR MESSAGE 
*MSG /PRINT DEMONSTRATION MF'iiiACK 

.AND L OOF- 



COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

.PRINT *BELL fRING BELL IN RESPONSE III MESSAGE 

.RCVDC *AREA. ♦BUFFER. MOO. tMSLUN tPOST ANOTHER MESSAGE RC QUEST 
RETURN fAND RETURN FROM COMPLETION ROUTINE 



ASCII MESSAGES 
.NLIST BEX 
.BYTE 7.200 



JMESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PROGRAM/ .15 12 

.ASCII /IF INCORRECTLY EDITED. THIS IS THE LASI LINE. 

.ASCII /UELL DONE./ 

.BYTE 



AREA! 

buffer: 



. BLKU 6 

.END START 



;emt argument area 

iftCVMC MESSAGE AREA 



DEMOBG MACRO V05.Qlb Friday 09-Dec-B3 10:16 Page 1-1 
Symbol table 



AREA 
BELL 



000226R 
00011 OR 



. .IBS. 000000 
000242 
Errors detected: 



000 
001 



SUFFER 000242R 
MSG 0001 12R 



CRUfI»GBLfABS.OVR> 
(RUiIfLCL.RELfCQN) 



*#* Assembler statistics 

Uork file reads : 

Uork file writes! 

Size of work filet 9188 Words ( 36 Pages) 

Size of core pool! 16128 Uords ( 63 PaSes) 

Operating system: RT-11 

Elapsed time! 00100:05.45 

DK ! DEMOBG r DK ! DEMOBG=HK I DEMOBG 



MSGIN 
START 



OOO044R 
OOOOOORG 
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3.9.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG.OBJ to produce an executable background program, DEM- 
OBG.SAV. 

.LINK DEMOBGdS) 



3.9.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 

• RUN DEMOBG© 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED . THIS IS THE LAST LINE, 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

fcTRL/C ] 

CTRL/C) 



If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

.RENAME SY:DEMOBG.BAK SY : DEMOBG . MAC© 



Then, repeat the editing procedure. 

3.9.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and execute it in conjunction 
with DEMOBG.SAV. DEMOFG.MAC is a small foreground program that 
sends a message every 2 seconds to DEMOBG (running in the background), 
telling it to ring the terminal bell. DEMOBG recognizes these messages 
and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings'. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

3.9.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 



3-14 Installing a System Distributed on RX01 to Run on a Small Device 



file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

- MACRO/LIST:LST: DEMOFG© 



The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

3.9.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

. LINK/FOREGROUND DEMOFGSl 1 



3.9.2.3 Run the Foreground and Background Demonstration Programs — Type 
the following command to load and start DEMOFG.REL as the foreground 
job. 

. FRUN DEMOFG-SLr 
F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 
EVERY 2 SECONDS, TELLING IT TO RING THE BELL. 
I CtrlJL 1 

b"> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG. SAV in the background and re- 
ceive the messages. 

. RUN DEM0BG(@E 

J (The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED , THIS IS THE LAST LINE, 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 

j 5trl"~c" ; 

£Wc"; 

(The bell stops ringing.) 

• DIRECTORY© 
d d - in m m - v v 

(The directory of the device DK prints on the terminal.) 
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Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

-RUN DEMOBG© 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

EtbTJcI 

CTBL/C) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 
Kthl/f ] 

F> 

EtrucI 

fcm/c ) 

B> 

UNLOAD FED 

If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

3.10 Performing the System Generation Process 

If you have decided that you need RT-ll features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-ll System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 4 

Installing a System Distributed on RX01 to Run on a 

Hard Disk 



If RT-ll was distributed to you on single-density diskette, and you intend 
to build a system to run on hard disk, perform the procedures described in 
this chapter. These procedures cover minor variations that depend on the 
specific device you have and assume that your configuration includes two 
hard disk drives. 

NOTE 

) If your hardware configuration includes a VT100 terminal, 

be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-ll. Never set TT NOPAGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, perform the steps summarized in the following list. 
Sections 4.1 through 4.11 describe the procedures involved in each step. 
Figure 4-1 shows the various backup volumes you create when you install 

\ TDTl 1 1 

I XV x — J. A. 

1. Bootstrap the distribution volume. 

2. Copy the distribution volumes to the disk. 

3. Preserve the distribution volumes. 

4. Install software updates. 

5. Create the working system from chosen components. 

6. Install the bootstrap on the disk. 

7. Customize the system. 

8. Compress the disk. 



4-1 



9. Preserve the working system. 

10. Test the working system. 

11. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 4—1: Sample Backup Disks 




BACKUP DISK 



^^ WORKING 
■22} SYSTEM 
DISK 



BACKUP 
WORKING 
SYSTEM 
DISK 



STORAGE CABINET 



4.1 Bootstrapping the Distribution Volume 

The first procedure you perform when installing RT-11 is to bootstrap the 
distribution volume. 

Begin by making sure that the processor is powered up but not running. 
Insert the distribution volume labeled 1 (write-protected) in RX01 diskette 
Unit 0. For RX01 diskette, the device name is DX.\ 

Use the hardware bootstrap to boot the volume. (If your configuration does 
not include a hardware bootstrap, see Appendix B for toggle-in software 
bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the volume: 
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RT-1 1FB '.'05. xx 
.TYPE i,'5USER.TXT 

RT-1 1 ','5. xx 



installation of RT-i i ....(followed by V5USER.TXT message) 



After you boot the system, you can create a start-up file containing any 
commands or sequence of commands that you would normally want to exe- 
cute at the start of each terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can 
execute it with the (a command, so that the commands it contains become 
effective. 



4.2 Copying the Distribution Volumes to the Disk 

With the RT-11 system running, copy all the distribution volumes to the 
disk that will serve as your working system disk. 

If the disk is an RK05 disk, mount the disk in Unit 0, format the disk, and 
then initialize it and cover any bad blocks on it. 

If the disk is another type, initialize the disk and replace or cover any bad 
blocks. You have a choice of replacing or covering bad blocks if your disk is 
an RK06, RK07, RL01, or RL02. If your disk is another type, you should 
cover any bad blocks. 

To replace bad blocks, use the INITIALIZE/REPLACE command, and to 
cover bad blocks, use the INITIALIZE/BADBLOCKS command (procedures 
follow). In the commands, xx is the permanent device name for your disk. If 
the disk contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn 
message appears on the terminal, but you can use the disk. 

RK05 disk 

.FORMAT RK0:*It» 

RKO: /FORMAT- A re you sure? Yi© 

7F0RMAT- I -Formatting complete 



.INITIALIZE/BADBLOCKS RKO :(REf) 

R K : / I n i t i a 1 i z e i Are you sure? Yffi 1 

?DUP-I-No bad blocks detected RKO: 
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Other type disk 

.INITIALIZE/BADBLOCKS xxO:SB) 

x x : / I n i t i a 1 i z e i Are you sure? Y® 
?DUP-I-No bad blocks detected xxO: 



or 



.INITIALIZE/REPLACE xxO:© 

xxO:/Initializei Are you sure? V® 
?DUP-I-No bad blocks detected x x : 



There is a delay as the system scans the disk for bad blocks and creates a 
new directory. The monitor dot appears when this process is complete. 



The next step in the preservation process is to copy all the files from distri- 
bution volume 1 to the initialized disk. The following command transfers 
files from the distribution volume to the disk and consolidates all the empty 
space at the end of the disk. In the command, xx is the permanent device 
name for your disk, and yy is the device name for the distribution device. 

,SQUEEZE/OUTPUT:xxO: yyO:® 

NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: op- 
tion and the COPY command transfer files from one device to 
another. SQUEEZE/OUTPUT:xxn: consolidates free space on 
the device at the same time. The procedures in this manual 
use the command that is most appropriate and most efficient 
for an individual operation. For a better understanding of all 
RT-11 keyboard monitor commands, refer to the RT-11 Sys- 
tem User's Guide. 

There may be a delay while the system performs this operation. 

You must also copy the rest of the distribution volumes to the disk. Insert 
distribution volume 2 in RX01 Unit 1. In the following command, xx is the 
permanent device name for your disk, and yy is the name for your distribu- 
tion device. The /SYSTEM option is required for copying .SYS files only if 
wildcards are used in the input file specification. 

.COPY/SYSTEM v/1: xxO:® 

Files copied: 
yyl:aaaaaa.ttt to xxO:aaaaaa.ttt 
y y 1 : b b b b b b . 1 1 1 to x x : b b b b b b , 1 1 1 



l:zzzzzz.ttt to xxO:zzzzzz.ttt 
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Insert distribution volume 3 in RX01 Unit 1, and repeat this command. 
Copy all the distribution volumes to your disk in this way. 

NOTE 

For optimal system performance, copy the distribution vol- 
umes in numerical order. 

Finally, copy the bootstrap to the disk and compress the disk. Use the 
following commands, where xx is the permanent device name for your disk. 

• COPY/BOOT xxOiRTHFB.SYS xxOs® 

• SQUEEZE xxO:® 

x xO : /Sq ue e ze i Are you sure? YdD 



4.3 Preserving the Distribution Volumes 

Halt the processor, and remove the distribution volumes. Then store them, 
as a safety measure in case of machine failure or human error. Use the disk 
to build a working system. Leave the write-enabled disk in Unit 0. Use the 
hardware bootstrap to boot RT-11 from your disk. 

RT-11FB V05.00 

(Followed by any start-up file commands.) 



NOTE 

If the disk does not boot, repeat the procedures to this point. 

Next, remove the protection from all the files on the backup disk. The files 
on the distribution volumes have been protected to prevent you from acci- 
dentally deleting them. (Refer to the RT-11 System User's Guide for a 
description of file protection.) When you used the SQUEEZE command to 
copy the files to the backup disk, RT-11 also copied the protection. (Note 
the P that prints next to the file size in the directory.) For the rest of these 
procedures, you need to remove the protection from the backup disk. Use 
the following command: 

• UNPROTECT/SYSTEM *.*® 

Files unprotected: 
DK : aaaaaa . ttt 
DK:bbbbbb. ttt 
DK:cccccc.ttt 
DK:dddddd, ttt 



DK:zzzzzz.ttt 
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4.4 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
base system and contain modules for both base system and layered prod- 
ucts. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

4.5 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have 
planned the best arrangement of them on a disk (Section 2.4), you can 
create the working system by copying selected components to another disk 
or disks. 

Mount a blank disk in disk Unit 1 and initialize it. If the disk is an RK05 
disk, format it before you initialize it. 

RK05 disk 

, FORMAT RK1 : (© 

RK1 : /FORMAT- A re you sure? Y(H) 

7F0RMAT- I -Format tins complete 

, INITIALIZE/BADBLOCKS RK1:@[T) 

R K 1 : / I n i t i a 1 i z e i Are you sure? Y@ 

?DUP-I-No bad blocks detected RK1: 

Other type disk 

.INITIALIZE/BADBLOCKS x x 1 : @J' 

x x 1 : / I n i t i a 1 i s e i Are you sure? Y© 

?DUP-I-No bad blocks detected xxl: 

or 

.INITIALIZE/REPLACE xxl:© 

x x 1 : / I n i t i a 1 i z e i Are you sure? Y (BED 

?DUP-I-No bad blocks detected xxl: 
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Copy the files you have selected from the disk in Unit to the disk in Unit 
1, which will become your working system disk. If you use the following 
command, RT-11 queries you about all the files on the disk in Unit 0, and 
you can choose the files it copies. 

.COPY/SYSTEM/QUERY xxO: xxl:@ 

Files copied: 
xxO:aaaaaa,ttt to xxl:aaaaaa,ttt? Y© (t include a specific file) 

xxO: bbbbbb . ttt to x x 1 : b b b b b b . 1 1 1 ? N© (to exclude a specific file) 

(and so on) 

4.6 Installing the Bootstrap on the Disk 

Once you have created your system, you need to install the bootstrap on the 
system disk. In the following command, aa is BL, SJ, FB, or XM. 

.COPY/BOOT xxl :RTllaa.SYS x x 1 : (H> 



In this command, you identify the device on which the monitor that con- 
tains the bootstrap information resides (your disk), the name of that moni- 
tor file (RT11BL, RT11SJ, RT11FB, or RT11XM), and the device on which 
you need to install the bootstrap (your disk). This command copies boot- 
strap information from the monitor file to blocks and 2 through 5 of the 
same disk. 

Remove the disk from Unit and store it for future updates. Mount the new 
working system disk in Unit 0, and use the hardware bootstrap to boot the 
working system disk. 

RT-l laa V05. xx 

(Followed by any start-up file commands.) 



4.7 Customizing the System 



) You may want to make certain customizations (described in Section 2.7) to 

the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 4.11.) 

4.8 Compressing the Disk 

DIGITAL recommends that you compress the working system disk to make 
its free space contiguous. Consolidating free space allows you to use space 
on the disk that would otherwise be too fragmented to be usable. 
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Use the SQUEEZE command to compress free space. (The volume must be 
write-enabled.) The squeeze operation does not move files with the .BAD 
file type. 

.SQUEEZE xxOjGD 

xxO : /Squeeze i Are you sure? Yffi) 

RT- 1 laa U05. xx 

(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 

.9 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files in the working system and back it up. 

Use the following command to protect all the files on the system disk: 

.PROTECT/SYSTEM *.*© 

Files protected: 
DK:aaaaaa.ttt 
DK: bbbb bb . ttt 
DK:ccccoc.ttt 
DK : dddddd .ttt 



DK : zzzzzz . t tt 

Now preserve the working system on the backup medium of your choice. 

4.9.1 Backing Up the System on RX01 Diskettes 

Insert a blank RX01 diskette in Unit 1 (with RT-11 still booted from disk 
Unit 0). Use the INITIALIZED ADBLOCKS command to initialize the 
blank diskette. Then, repeat the process to initialize the appropriate num- 
ber of diskettes. 

Copy all the files in your working system, using the COPY/MULTI- 
VOLUME command. In the command, yy is the name for your disk. The 
system copies all the files from the input volume that will fit on the output 
volume. When no more files will fit on the output volume, the system 
prompts you to mount the next output volume and prints the Continue? 
message. 

Mount another blank, initialized diskette, and type Y to continue. Continue 
to mount diskettes in this fashion until all the files are copied. 

. COPY/MULTIVOLUME/SYSTEM >• >• : DX1:<SH) 

Files copied: 
y y : a a a a a a . 1 1 1 to D X 1 : a a a a a a . 1 1 1 
y v : b b b b b b . 1 1 1 to D X 1 : b b b b b b . 1 1 1 

(and so on) 
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Mount next o u t p u t u o 1 u m e in D X 1 : i Co n t i n u e ? Y 

(Log of files copied) 

M o u n t nextoutp u t u o 1 u w e in D X 1 : i C o n t i n u e ? Y 

(Log of files copied) 

M o u n t next o u t p u t u o 1 u m e in D X 1 : > C o n t i n u e ? Y 

(Log of files copied) 

Mount next o u t p u t u o 1 u w e i n D X 1 : ! C o n t i n u e ? Y 

(Log of files copied) 

Mount next o u t p u t u o 1 u m e i n D X 1 : 5 C o n t i n u e ? Y 

(and so on) 

Then, copy the bootstrap to the backup diskette that will be bootable. Re- 
member that a bootable volume needs a monitor file, a system device han- 
dler, the file SWAP.SYS, and for the SJ monitor, TT.SYS. 

, COPY/BOOT xxl :RTllaa.SYS xxl:© 



Store the backup diskettes. If you ever need to restore the working system, 
you can copy the backup diskettes to the disk. 

4.9.2 Backing Up the System on Another Disk 

To back up your system on another disk, initialize a blank disk and copy all 
the files from the working system disk to the backup disk. In the following 
commands, xx is the permanent device name for your disk. 

RK05 disk 

.FORMAT RK1 : EH) 

RK1 :/FORMAT-Are you sure? YES 

?FORMAT-I-Formattin3 complete 

.INITIALIZE/BADBLOCKS RK1:(BH> 
RK1:/Initialize» Are you sure? YES) 
?DUP-I-No bad blocks detected RK1: 



) Other type disk 



.INITIALIZE/BADBLOCKS x x 1 : EH) 

x x 1 : / I n i t i a 1 i z e ! Are you s u r e ? Yd] 
?DUP-I-No bad blocks detected xxl 



or 



.INITIALIZE/REPLACE xxl:© 

x x 1 : / I n i t i a 1 i z e i Are you sure? Y EED 

?DUP-I-No bad blocks detected xxl: 



Copy all the files in your working system. 

,SQUEEZE/OUTPUT:xxl s xxO:@H> 



Installing a System Distributed on RX01 to Run on a Hard Disk 4-9 



Copy the bootstrap to the backup working system disk. In the following 
command, aa is BL, SJ, FB, or XM. 

.COPY/BOOT xxl:RTllaa.SYS xxl:@B) 

Store the backup working system disk. If you ever need to restore the 
working system, you can make a copy of the backup working system disk. 

4.10 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 

RT11FB.SYS 

xx. SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 

, DIRECTORY/BRIEF/COLUMNS: 1 SY:ffl) 

d d - m m m - v v 
SWAP .SYS 
RT1 1FB.SYS 
LP .SYS ' 
DX .SYS 
EDIT . SAV 
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MACRO . SAV 
SYSMAC.SML 
LINK . S A '.' 
PIP . SA',< 



x k x Files ) bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s ) to stop the display and 
(Ctrl.-' q) to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 

4.10.1 Preparing the Background Demonstration Program 

4.10.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

.edit sy:dem0bg_. mac© 
*f;®.ascii( 

*0AC 
*EX(j 



4.10.1.2 Assemble the Background Demonstration Program — The back- 
ground program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble 
DEMOBG.MAC and obtain a listing, make sure that your configuration 
has a line printer that is on-line and ready. 

.ASSIGN LP: LST:(© 
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NOTE 

If your configuration does not include a line printer, use the 
console terminal. 



, ASSIGN 



TTs LSTsI 



Assemble DEMOBG.MAC as follows: 



,MACRO/LIST:LST: DEMOB 
(See Figure 4-2.) 



If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

.RENAME SYsDEMOBG.BAK SY s DEMOBG . MAC® 



Figure 4-2: DEMOBG Assembly Listing 



DEMOBG MACRO Y05.01b Friday 09-Dec-83 10:16 Pag* 1 



OOOOOO 
0000.11 
00004'.? 000777 



1)00011 
OOOOIj"! 
000] O^i 0OOJ0 7 



000 1 1 2 
000117 



ooo:.*?6 

ooo:'i? 



121 
10A 



.TITLE DEMOBG 

.ident /voa.oo/ 

i DEMONSTRATION PROGRAM TQ PRINT DEMONSTRATION MESSAGE, THEN 
f RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC. .PRINT 

START:: .RCVDC *AREA,*BUFFERr*400»*MSGIN {POST REQUEST FOR MESSAGE 
.PRINT tMSG {PRINT DEMONSTRATION MESSAGE 

BR . <AND LOOP 

i COMPLETION ROUTINE ENTERED UHEN FG SENDS MESSAGE 

MSGIN" .PRINT *BELL 'RING BELL IN RESPONSE TO MESSAGE 

.RCVDC #AREAr*BUFFER-*400T*HSGIN (POS TANOTHER MESSAGE _ REQUEST ^ 

RETURN ' "" ~" -.-«>■ 



fAND RETURN FROM COMPLETION ROUTINE 



bell: 
msg: 



area: 
buffer: 



ASCII MESSAGES 
.NLIST BEX 
.BYTE 7,200 



{MESSAGE THAT RING5 BELL 



• ASCII /RT-11 DEMONSTRATION PROGRAM/ ;15; ■ <12> 

.ASCII /IF INCORRECTLY EDITED, THIS IS THE LAST LINE. /-IS 

.ASCII /WELL DONE./ 

.BYTE 



. BLKU 6 

.END 



JEMT ARGUMENT AREA 

{RCVDC MESSAGE AREA 



DEMOBG MACPO V05.01b Friday 09-0ec-83 10:16 Page 1- 
Swmbol t.ahlP 



ARFA 000. '2AR 

BELl 0001 10R 

. ABS. OOOOOO 

coon? 

Lrrors detected! t) 

*** Assembler st.ati 

Wor^ f i \e reads '. 
Work Tile untK 



000 

001 



BUFFER 000212R 
MSG 000112R 



(RU.I.GBL.ABS.OVR) 

<RW,I rLCLtftEL.CON) 



MSGIN 

START 



000014R 

OOOOOORG 



tJporatir.3 



rp Pool 



SMH8 Words 
1M2S Words 
RT-11 



36 Pases) 
( 63 P33es) 



Elai-sed t.mn?:. 00:00:0:5.15 

DKIDEMOBG.DMDEMUBG-DNMiEMOHli 



,vi - 000003 



.V2 - 000027 



4.10.1.3 Link the Background Demonstration Program — Link the pro- 
gram DEMOBG.OBJ to produce an executable background program, 
DEMOBG.SAV. 

.LINK DEMOBG© 
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; 



4.10.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 

•RUN DEMOBG® 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED* THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

(CTRL/C) 

gUTcl 

If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

• RENAME SYsDEMOBG.BAK SY s DEMOBG . MAC© 

Then, repeat the editing procedure. 

4.10.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and execute it in conjunction 
with DEMOBG.SAV. DEMOFG.MAC is a small foreground program that 
sends a message every 2 seconds to DEMOBG (running in the background), 
telling it to ring the terminal bell. DEMOBG recognizes these messages 
and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
) periods when DEMOBG is not running, DEMOFG enters the messages in 

the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

4.10.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

•MACRO/LISTsLSTs DEMOFG® 

The output resulting from this MACRO command is an object file called 
DEMOFG. OBJ. This file resides on your system volume. 
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4.10.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

• LINK/FOREGROUND DEMOFGdS 



4.10.2.3 Run the Foreground and Background Demonstration Programs — 

Type the following command to load and start DEMOFG.REL as the fore- 
ground job. 

• FRUN DEMOFGdU 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS) TELLING IT TO RING THE BELL. 

(CTRL/B ) 

B> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG. SAV in the background and re- 
ceive the messages. 

•RUN DEMOBGdU 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE, 

WELL DONE, 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 



tCTRL/ C i 

(CTRL/C) 

(The bell stops ringing.) 

•DIRECTORY© 
d d - m h) m - y v 

(The directory of the device DK prints on the terminal. 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

•RUN DEMOBG®) 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 
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RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE, 

WELL DONE. 



ICTRl/C ) 
CTRl/C) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 

{CTRL/F ) 

F> 

iCTRL/C) 

iCTRL/C) 

B> 

UNLOAD F© 



If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

4.11 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-11 System Generation Guide for guidance in planning and performing 
system generation. 



Installing a System Distributed on RX01 to Run on a Hard Disk 4-15 



Chapter 5 

Installing a System Distributed on Hard Disk to Run 
on Hard Disk 



If RT-ll was distributed to you on hard disk (RL01/RL02, RK05, or RC25), 
and you intend to build a system to run on hard disk, perform the proce- 
dures described in this chapter. These procedures assume that your config- 
uration includes two disk drives (not necessarily of the same type). 

NOTE 

If your hardware configuration includes a VT100 terminal, 
be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-ll. Never set TT NOP AGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, perform the steps summarized in the following list. 
Sections 5.1 through 5.10 describe the procedures involved in each s f .ep. 
Figure 5-1 shows the various backup disks you create when you install 
RT-ll on a hard disk other than RC25. 

Figure 5-2 illustrates the backup procedure for installing RT-ll on an 
RC25 disk. Notice that files are deleted from the backup disk (a fixed de- 
vice) to create the working system disk. 

1. Bootstrap the distribution disk. 

2. Preserve the distribution disk. 

3. Install software updates. 

4. Create the working system from chosen components. 

5. Install the bootstrap on the disk. 

6. Customize the system. 

7. Compress the disk. 

8. Preserve the working system. 



5-1 



9. Test the working system. 

10. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 5-1: Sample Backup Disks (RL01, RL02, RK05) 

COPY AND INSTALL UPDATES 

'" l ™ BACKUP DISK 




. WORKING 

^ SYSTEM 

DISK 



STORAGE CABINET 



Figure 5-2: Sample Backup Disks (RC25) 



DELETE 

SELECTED 

FILES 




BACKUP DISK 
(FIXED) 



WORKING 
SYSTEM 
DISK 
(FIXED) 



STORAGE CABINET 



BACKUP 

WORKING 

SYSTEM 

DISK 

(REMOVABLE) 
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5.1 Bootstrapping the Distribution Disk 

The first procedure you perform when installing RT-11 is bootstrapping 
the distribution disk. 

Begin by making sure that the processor is powered up but not running. 
Mount the distribution disk (write-protected) in disk Unit 0. The device 
name is DL, RK, or DU, depending on the type of disk device. Use the 
hardware bootstrap to boot the disk. (If your configuration does not include 
a hardware bootstrap, refer to Appendix B for the toggle-in software boot- 
strap.) 

RL02 and RC25 disks are normally installed manually. If you successfully 
bootstrap an RL02 or an RC25 disk, RT-11 responds with the dialog and 
installation verification message below. The dialog gives you the choice of 
installing RT-11 manually or by using the automatic installation proce- 
dure. 

If you successfully bootstrap an RL01 or an RK05 disk, RT-11 responds 
with the installation verification message below. 

Welcome to RT-11 Version 5 . 

You h a m e bootstrapped the RT-11 Distribution D i s K . Use this d i s K to 
install your RT-11 s y s t e m i then store it in a safe place. 

RT-11 V 5 provides an automatic installation procedure which will 
back u p your d i s t r i b u t i o n disk a n d b u i 1 d a worKinJ svste m disk which 
should be used for your work with RT-11. This working system disk 
will only contain the RT-11 operating system. After the RT-11 
installation is complete* follow the installation instructions 
packaged with any optional lanSuaJes or utility software which you 
will be u sins. 

P r e s 5 the "RETURN" key when ready to continue.!® 

You can choose to install RT-11 manually, This procedure is 

described in the RT-11 Installation Guide. 

If you are a new user of RT-11 > DIGITAL highly recommends that you 
use the automatic installation procedure. 

Do you want to use the automatic installation procedure? 
(Type YES or NO and press the "RETURN" key): NO(® 

The standard RT-11 monitor bootstrap ( R T 1 1 F B ) will now be 
copied to this disk and this system disk will be rebooted. 
Please refer to the RT-11 Installation Guide for assistance 
while manually installing RT-11 Version 5 . 

Press the "RETURN" key when ready to continue.!® 

RT-11FB V05. xx 

.TYPE V5USER.TXT 

RT-11 V5.xx 

installation of RT-ii ....(followed by V5USER.TXT message).... 
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Now you can create a start-up file containing any commands or sequence of 
commands that you would normally want to execute at the start of each 
terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can 
execute it with the (a. command, so that the commands it contains become 
effective. 

5.2 Preserving the Distribution Disk 

The first procedure you perform with the running RT-11 system is to copy 
the distribution disk for backup, as a safety measure in case of machine 
failure or human error. You can then use the backup copy of the distribu- 
tion disk to build your working system. 

Mount a blank disk in the other disk drive, if necessary. (The disk in Unit I 
of RC25 devices is permanently mounted.) If the disk is an RK05 disk, 
format it, and then initialize it and cover any bad blocks on it. 

If the disk is another type, initialize the disk and replace bad blocks (using 
the command INITIALIZE/REPLACE) or cover bad blocks (using the com- 
mand INITIALIZE/BADBLOCKS). You have a choice of replacing or cover- 
ing bad blocks if your disk is an RK06, RK07, RL01, or RL02. (Refer to the 
RT-11 System User's Guide.) If your disk is another type, you should use 
INITIALIZE/BADBLOCKS to cover any bad blocks. If the disk contains 
bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on 
the terminal, but you can use the disk. In the commands, xx is the perma- 
nent device name and n is the unit number for your disk. 

RK05 disk 

•FORMAT RKnsI© 

RKn : /FORMAT- A re you sure? y© 
?F0RMAT-I-Fo rutatt i n <r complete 

•INITIALIZE/BADBLOCKS RKns® 

RKn:/Initializei Are v o u sure? y (MI) 
?DUP-I-No bad blocks detected RKn: 

Other type disk 

•INITIALIZE/BADBLOCKS xxn:(® 

x x n : / I n 1 t i a 1 i z e i Are you sure? Y(HD 
?DUP-I-No bad blocks detected x x n : 

or 

•INITIALIZE/REPLACE xxnsdD 

x x n : / I n i t i a 1 i z e i Are you sure? Y(HD 
?DUP-I-No bad blocks detected xxn: 



5-4 Installing a System Distributed on Hard Disk to Run on Hard Disk 



The system scans the disk for bad blocks and creates a new directory. The 
monitor dot appears when this process is complete. 



The next step in the preservation process is to copy all the files from the 
distribution disk to the initialized blank disk. 

The following command transfers files from the distribution to the backup 
disk and consolidates all the empty space at the end of the disk. In the 
command, yyn is the device name and unit number of your distribution 
disk, and xxn is the device name and unit number of your backup disk. 

•SQUEEZE/OUTPUTsxxn: yyn!® 



NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: op- 
tion and the COPY command transfer files from one device to 
another. SQUEEZE/OUTPUT:xxn: consolidates free space on 
the device at the same time. The procedures in this manual 
use the command that is most appropriate and most efficient 
for an individual operation. For a better understanding of all 
RT-11 keyboard monitor commands, refer to the RT-11 Sys- 
tem User's Guide. 

Next, copy the bootstrap to the backup disk. 
•COPY/BOOT xxnsRTHFB.SYS xxn:® 



Now halt the processor, remove the distribution disk from Unit 0, and store 
it. For RC25 devices, use the hardware bootstrap to boot the backup disk on 
disk Unit 1; for all other devices, mount the backup disk on Unit 0, and use 
the hardware bootstrap to boot the backup disk. 

RT-11FB VOS.xx 

(Followed by any start-up file commands.) 

* 

NOTE 

If the backup disk does not boot, repeat the procedures to this 
point. 

Next, remove the protection from all the files on the backup disk. The files 
on the distribution disk have been protected to prevent you from acciden- 
tally deleting them. (Refer to the RT-11 System User's Guide for a descrip- 
tion of file protection.) When you copied the files to the backup disk, RT-11 
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also copied the protection. (Note the P that prints next to the file size in the 
directory. ) For the rest of these procedures, you need to remove the protec- 
tion from the backup disk. Use the following command: 



.UNPROTECT/SYSTEM *.*<L 

Files unprotected: 
DK:aaaaaa.ttt 
DK : bbbbbb . ttt 
DK:ccccccittt 
DK : dddddd .ttt 



DK 



:zzzzz.ttt 



5.3 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
base system and contain modules for both base system and layered prod- 
ucts. 

When you. submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

5.4 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have 
planned the best arrangement of them on disks (Section 2.4), you can create 
the working system. 

If you are using an RC25 disk, you create your working system by deleting 
selected components from the backup disk. Use the following command to 
delete unnecessary components: 



.DELETE/SYSTEM/QUERY DU1 

Files deleted? 
DUl:aaaaaa,ttt? YSED 
DU1 : bbbbbb: ttt? 

(and so on) 



(to delete a specific file) 
(to keep a specific file) 
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For all other disks, you create your working system by copying selected 
components to one or more disks. 

Mount a blank disk in another disk unit and initialize it. If your disk is an 
RK05, format the disk before you initialize it. 

RK05 disk 

, FORMAT RKn:® 

RKn:/FORMAT-Are you sure? Y® 
?FORMAT-I-Fo r m at tins complete 



, INITIALIZE/BADBLOCKS RKn:® 

R K n : / I n i t i a 1 i z e i Are you sure? Y 

?DUP-'I-No bad b 1 o c K s detected RKn 



Other type disk 

, INITIALIZE/BADBLOCKS xxn:® 

x xn : / In i t i a 1 i ze i Are you sure? Y® 
?DUP-I-|\la bad blocks detected x x n : 



or 



, INITIALIZE/REPLACE xxn:® 

x x n : / I n i t i a 1 i z e ! Are you sure? Y (1 

?DUP-I-No bad blocks detected xxn 



Copy the files you have selected from the backup disk to the disk that will 
become your working system disk. If you use the following command, 
RT-11 queries you about all the files on the backup disk, and you can 
choose the files it copies. In the command, yyn is the device name and unit 
number of your backup disk, and xxn is the device name and unit number 
of the disk to be your working system disk. 



, COPY/SYSTEM/QUERY yyn: xxn:® 

Files copied: 
y y n : aaaaaa . 1 1 1 to xxn: aaaaaa. ttt? Y® 
y •/ n : b b b b b b . 1 1 1 to x x n : b b b b b b . 1 1 1 ? N® 

(and so on) 



(to include a specific file) 
(to exclude a specific file) 



If you wish -to create multiple working system disks, mount one blank disk 
for each working system you wish to create, format blank RK05 disks, and 
initialize the disks. Then, use the preceding COPY command to copy se- 
lected files to the appropriate disks. 

5.5 Installing the Bootstrap on the Disk 

Once you have created your working system disk(s), you need to install the 
bootstrap on all disks, except RC25. In the following command, aa is BL, 
SJ, FB, or XM. 

.COPY/BOOT xxn:RTllaa.SYS xxn:® 
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In this command, you identify the device on which the monitor that con- 
tains the bootstrap information resides, the name of that monitor file 
(RT11BL, RT11SJ, RT11FB, or RT11XM), and the device on which you 
need to install the bootstrap. This command copies bootstrap information 
from the monitor file to blocks and 2 through 5 of the same disk. 

Remove the backup disk from Unit and store it for future updates. Re- 
move the working system disk from Unit n and mount it on Unit 0. 

Use the hardware bootstrap to boot the new working system disk. 

RT-l laa V05. xx 

(Followed by any start-up file commands.) 



5.6 Customizing the System 



You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 



NOTE 



Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 5.10.) 



5.7 Compressing the Disk 



DIGITAL recommends that you compress the working system disk to make 
its free space contiguous. Consolidating free space allows you to use space 
on the disk that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit (Unit 1 for RC25 disk), and use the 
SQUEEZE command to compress free space. (The disk must be write- 
enabled.) The squeeze operation does not move files with the .BAD file 
type. 

. SQUEEZE xxn:(H) 

xx n : /Squeeze i Are you sure? Y(ED 

RT-l laa V05. xx 

(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 
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5.8 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you preserve it on the backup medium of your choice. The following sec- 
tions describe backing up on disk. If you want to back up the system on 
another device, the procedure may appear elsewhere in this manual; refer 
to the table of contents. 

Insert a blank disk (write-enabled) in another disk unit and initialize the 
blank disk. If your disk is an RK05, format the disk before initializing it. In 
the following commands, xxn is the device name and unit number for the 
backup working system disk. 

RK05 disk 

.FORMAT RKn:© 

RKn: /FORMAT~Are you sure? Y© 

?FORMAT-I-FormattinS complete 

.INITIALIZE/BADBLOCKS RKn:© 

RKn : /Ini t i al i ze 5 Are you sure?Y© 

?DUP-I-No bad blocks detected RKn: 

Other type disk 

.INITIALIZE/BADBLOCKS xxn:© 

xxn : / In i t i al i ze ! Are you sure? Y© 

?DUP-I-No bad blocks detected xxn: 



or 



.INITIALIZE/REPLACE xxn:© 

< x n : / I n i t i a 1 i z e ! Are you sure? Y(H 

? DUP-I-No bad blocks detected xxn 



Copy all the files in your working system. In the following command, yyn is 
the device name and unit number for your working system disk, and xxn is 
the device name and unit number for the backup working system disk. 



,SQUEEZE/OUTPUT:xxn yyn; 



Copy the bootstrap to the backup working system disk. In the following 
command, aa is BL, SJ, FB, or XM. 



, COPY/BOOT xxmRTllaa.SYS xxn:( 
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Store the backup working system disk. If you ever need to restore the 
working system, you can make a copy of the backup working system disk. 

5.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 

RT11FB.SYS 

xx. SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 

. DIRECTORY/BRIEF/COLUMNS: 1 SYs© 

d d - di m m - y y 
SWAP .SYS 
RT1 1FB.SYS 
LP .SYS 

RK .SYS 

EDIT , SAM 
MACRO .SAM 
SYSMAC.SML 
LINK .SAM 
PIP .SAM 



x x x Files., b b b B 1 o c K s 
fff Free blocKs 

NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s ) to stop the display and 
(ctrl q ) to restart it. 
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Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 



5.9.1 Preparing the Background Demonstration Program 

5.9.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 



.edit sy:demobg.mac© 
*f;®,asciic 

*0A[ 



5.9.1.2 Assemble the Background Demonstration Program — The background 
program, DEMOBG.MAC, is an assembly language source file; it must 
be assembled and linked before you can execute it. To assemble 
DEMOBG.MAC and obtain a listing, make sure that your configuration 
has a line printer that is on-line and ready. 

.ASSIGN LP: LST:© 



NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

•ASSIGN TT: LST:© 



Assemble DEMOBG.MAC as follows: 

,MACRO/LIST:LST: DEMOBG© 

(See Figure 5-3.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

.RENAME SY:DEMOBG.BAK SY : DEMOBG . MAC© 
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Figure 5-3: DEMOBG Assembly Listing 



OEMOBG MACRO U05.01b Friday 09-Dec-83 10:16 Pag* 1 



000000 
0000.1-1 
00004 :.' 000777 



000014 

oooorj? 

0O0JOA 000207 



:'o ooo] lo 007 



?? 


000 11 'J 


i: 1 : 1 


:m 


000147 


nt 


24 






?i> 


ooo: 1 ? 1 ! 


000 


:*6 






27 


000226 




28 


0002-12 




29 




000000 



.TITLE DEMOBG 

. I DENT /yOS.OO/ 
DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGEf THEN 
RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC* .PRINT 

TART!: .RCVDC *AREAr*BUFFER.*400.*MSGIN fPOST REQUEST FOR MESSAGE 
.PRINT *MSG SPRINT DEMONSTRATION MESSAGE 

BR . »AND LOOP 

COMPLETION ROUTINE ENTERED UHEN FG SENDS MESSAGE 

SGIN: .PRINT *BELL 5RING BELL IN RESPONSE TO MESSAGE 

.RCWDC *AREA,*BUFFER»#400»#MSGIN fPOST ANOTHER MESSAGE REQUEST 
RETU R N iAND RETURN FROM COMPLETION ROUTINE 

ASCII MESSAGES 
.NLIST BEX 
.BYTE 7 i 200 



bell: 
msg: 



(MESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PR0GRAM/<15|:- : 12 ■ 

.ASCII /IF INCORRECTLY EDITEr.ii THIS IS THE LASI LINE./' 

.ASCII /WELL DONE./ 

.BYTE 



area: 
buffer: 



.BLKU 6 

.END START 



;emt argument area 
(rcvpc message area 



DEMOBG MACfrG V05.01b Friday 09-Oec-83 10:16 Page 1-1 
Symbol lat.U' 



ARFA 00022.SR 

BEll 0001 10R 



AH5- 000000 

000242 



ooo 

001 



BUFFER 
MSii 



0002 4 2R 
000 U2R 



(RU.I.tiBL.ABSrOyR) 
CRWTl.LCL.REL.flQNJ 



MSGIN 
START 



00004 4R 
OOOOOORG 



. .V2 - 00002 



Sire of uorV file! 91GB Words 
fii^e nf t dtp pool! 16128 Uonl* 
Operating ssstem: RI-11 

Elar-'iPd Lime: 00 : 00 I ,! j . 45 

UK I DEMOBG r DK ! DfMOBG- UN : DEMOBIi 



( 36 PaSes) 

( 63 Pages) 



5.9.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG. OBJ to produce an executable background program, DEM- 
OBG.SAV. 

, LINK DEMOBG© 



5.9.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 

, RUN DEMOBGdD 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 



CTRL/ CI 
CTRL/C) 
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If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

. RENAME SY:DEMOBG.BAK SY : DEMOBG . MAC© 



Then, repeat the editing procedure. 



5.9.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and execute it in conjunction 
with DEMOBG.SAV. DEMOFG.MAC is a small foreground program that 
sends a message every 2 seconds to DEMOBG (running in the background), 
telling it to ring the terminal bell. DEMOBG recognizes these messages 
and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

5.9.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

. MACRO/LI ST: LSTs DEMOFG© 



The output resulting from this MACRO command is an object file called 
DEMOFG. OBJ. This file resides on your system volume. 

5.9.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

• LINK/FOREGROUND DEMOFGSH) 
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5.9.2.3 Run the Foreground and Background Demonstration Programs — Type 
the following command to load and start DEMOFG.REL as the foreground 
job. 

,FRUN DEMOFGdH) 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

BENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EMER Y 2 SECONDS* TELLING IT TO RING THE BELL, 

(CTRL/B ) 

B> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG. SAV in the background and re- 
ceive the messages. 

,RUN DEMOBG© 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED , THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 

(CTRL/C) 
1CTRL/C) 

(The bell stops ringing.) 
.DIRECTORY® 

d d - w in m - y v 

(The directory of the device DK prints on the terminal.) 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

.RUN DEMOBGdJ) 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED , THIS IS THE LAST LINE. 

NELL DONE. 

(CTRL/c) 

(CTRL/C) 

(The bell stops ringing.) 
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Now, stop the foreground program and remove it from memory. 



(CTRl/F ] 

F> 

CTRL/C) 
ICTRL/C) 

UNLOAD FdH 



If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

5.10 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-11 System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 6 

Installing a System Distributed on Hard Disk to Run 

on a Small Device 



If RT-ll was distributed to you on hard disk (RL01/RL02, RK05, or RC25), 
and you intend to build a system to run on a small device (RX01, RX02, or 
RX50), perform the procedures described in this chapter. These procedures 
assume that your configuration includes two hard disk drives (not necessar- 
ily of the same type). 

NOTE 

If your hardware configuration includes a VT100 terminal, 
be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-ll. Never set TT NOPAGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, perform the steps summarized in the following list. 
Sections 6.1 through 6.10 describe the procedures involved in each step. 
Figure 6-1 shows the backup disk and diskettes you create when you in- 
stall RT-ll. 

1. Bootstrap the distribution disk. 

2. Preserve the distribution disk. 

3. Install software updates. 

4. Create the working system from chosen components. 

5. Install the bootstrap on diskettes that need to be bootable. 

6. Customize the system. 

7. Compress each diskette. 

8. Preserve the working system. 



6-1 



9. Test the working system. 

10. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 6-1: Sample Backup Disk and Diskettes 
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6.1 Bootstrapping the Distribution Disk 

The first procedure you perform when installing RT-11 is to bootstrap the 
distribution disk. 

Begin by making sure that the processor is powered up but not running. 
Mount the distribution disk (write-protected) in disk Unit 0. The device 
name is DL, RK, or DU, depending on the type of disk device. Use the 
hardware bootstrap to boot the disk. (If your configuration does not include 
a hardware bootstrap, refer to Appendix B for the toggle-in software boot- 
strap.) 

RL02 and RC25 disks are normally installed manually. If you successfully 
bootstrap an RL02 or an RC25 disk, RT-11 responds with the following 
dialog and installation verification message. The dialog gives you the 
choice of installing RT-11 manually or by using the automatic installation 
procedure. 

If you successfully bootstrap an RL01 or an RK05 disk, RT-11 responds 
with the following installation verification message. 
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Welcome to RT- I 1 Version 5 ■ 

You haue bootstrapped the RT- i 1 Distribution Disk. Use this disk to 
install your R T - 1 1 system then store it in a safe place. 

R T - 1 1 M 5 provides an automatic installation procedure which vi 1 1 
back u p your d i s t r i b u t i o n disk a n d b u i 1 d a w o r K i n <f s y s t e m disk w h'i c h 
should be used for your work with R T - 1 1 . This w o r k i n 4 s y s t e m disk 
will only contain the R T - 1 1 operating system. After the R T - 1 1 
installation is complete t follow the installation instructions 
packaged with any optional 1 a n 3 u a 3 e s or utility software which you 
w ill be Li s i n 3 . 

Press the "RETURN" key when ready to continue.© 

You can choose to install RT-11 manually, This procedure is 

described in the RT-11 Installation Guide. 

If you are a new user of RT-11 , DIGITAL hisfhly recommends that you 
use the automatic installation procedure. 

Do you want to use the automatic installation procedure'? 
(Type YES or NO and press the "RETURN" key): NO© 

The standard RT-11. monitor bootstrap ( R T 1 1 F B ) will now be 
copied to this disk and this system disk will be rebooted. 
Please refer to the RT-11 Installation Guide fo.r assistance 
while manually installing RT-11 M e r s i o n 5 , 

Press the "RETURN" key when ready to continue,© 

RT- 1 1FB MO 5 . xx 

.TYPE U5USER.TXT 

RT-1 1 M5. xx 

installation of RT-H ....(followed by V5USER.TXT message).... 



Now you can create a start-up file containing any commands or sequence of 
commands that you would normally want to execute at the start of each 
terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can 
execute it with the (a command, so that the commands it contains become 
effective. 

8.2 Preserving the Distribution Disk 

The first procedure you perform with the running RT-11 system is to copy 
the distribution disk for backup, as a safety measure in case of machine 
failure or human error. You can then use the backup copy of the distribu- 
tion to build your working system. 

Mount a blank disk in the other disk drive, if necessary. (The disk in Unit 1 
of RC25 devices is permanently mounted.) If the disk is an RK05 disk, 
format the disk, and then initialize it and cover any bad blocks on it. 
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If the disk is another type, initialize the disk and replace bad blocks (using 
the command INITIALIZE/REPLACE) or cover bad blocks (using the com- 
mand INITIALIZE/BADBLOCKS). You have a choice of replacing or cover- 
ing bad blocks if your disk is an RL01, RL02, RK06, or RK07. (Refer to the 
RT-11 System User's Guide.) If your disk is another type, for example, 
RC25, use INITIALIZE/BADBLOCKS to cover any bad blocks. If the disk 
contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message 
appears on the terminal, but you can still use the disk. In the commands, xx 
is the permanent device name, and n is the unit number for your disk. 

RK05 disk 

•FORMAT RKn:dB 

RKn : /FORMAT-Are you sure? Y© 
?FORMAT-I-ForwattinS complete 

. INITIALIZE/BADBLOCKS RKn i IE) 

R K n : / I n i t i a 1 i z e ! Are you sure? Y© 
?DUP-I-No bad blocks detected RKn: 

Other type disk 

.INITIALIZE/BADBLOCKS xxnrffl) 

x k n : / I n i t i a 1 i z e > Are you sure? Y@) 
? D U P - I - N o bad blocks detected x x n : 



or 

.INITIALIZE/REPLACE xxn:(E) 

x x n : / I n i t i a 1 i z e i Are you sure? Y(RET) 
^DUP-I-No bad blocks detected xxn: 

The system scans the disk for bad blocks and creates a new directory. The 
monitor dot appears when this process is complete. 



The next step in the preservation process is to copy all the files from the 
distribution disk to the initialized blank backup disk. 

The following command transfers files from the distribution disk to the 
backup disk and consolidates all the empty space at the end of the disk. In 
the command, yyn is the device name and unit number of your distribution 
disk, and xxn is the device name and unit number of your backup disk. 

. SQUEEZE/OUTPUT: xxn: yyn:(H> 



NOTE 

Both the SQUEEZE command with the /OUTPUT:xxn: op- 
tion and the COPY command transfer files from one device to 
another. SQUEEZE/OUTPUT:xxn: consolidates free space on 
the device at the same time. The procedures in this manual 
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use the command that is most appropriate and most efficient 
for an individual operation. For a better understanding of all 
RT-11 keyboard monitor commands, refer to the RT-11 Sys- 
tem User's Guide. 

Next, copy the bootstrap to the backup disk. 
• COPY/BOOT xxn:RTHFB.SYS xxn:@B 



Now halt the processor, remove the distribution disk from Unit 0, and store 
it. For RC25 devices, use the hardware bootstrap to boot the backup disk on 
disk Unit 1. For all other devices, mount the backup disk on Unit 0, and use 
the hardware bootstrap to boot the backup disk. 

RT-l 1FB V05 . xx 

(Followed by any start-up file commands.) 

NOTE 

If the backup disk does not boot, repeat the procedures to this 
point. 

Next, remove the protection from all the files on the backup disk. The files 
on the distribution disk have been protected to prevent you from acciden- 
tally deleting them. (Refer to the RT-11 System User's Guide for a descrip- 
tion of file protection.) When you copied the files to the backup disk, 
RT-11 also copied the protection (note the P that prints next to the file size 
in the directory). For the rest of these procedures, you need to remove the 
protection from the backup disk. Use the following command: 

• UNPROTECT/SYSTEM * . *@S) 

Files unprotected: 
DKiaaaaaa.ttt 
DK : bbbbbb . ttt 
DK:occccctttt 
DK : dddddd .ttt 



DK:zizzzz.ttt 



6.3 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
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merit is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
base system and contain modules for both base system and layered prod- 
ucts. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

5.4 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have 
planned the best arrangement of them on diskettes (Section 2.4), you can 
create the working system by copying selected components to blank disk- 
ettes. 

6.4.1 initializing RX50 Diskettes 

If you wish to create your working system on RX50 diskettes, insert a 
blank RX50 diskette in Unit 1 or 2 so you can initialize it. You can use the 
INITIALIZE command with the /BADBLOCKS option to initialize the disk- 
ette and to detect any bad blocks that may be on it. If the diskette contains 
bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on 
the terminal. In the command, x is the device unit number. 

NOTE 

RX50 diskettes are not formattable. DIGITAL recommends 
that you use only diskettes that have no bad blocks. To ascer- 
tain whether an already initialized diskette has bad blocks, 
use the command DIRECTORY/BAD DUn:. If bad blocks ex- 
ist on a diskette, copy the contents of the diskette to an error- 
free diskette, and dispose of the diskette with bad blocks. 

•INITIALIZE/BADBLOCKS DUxs®) 

D U x : / I n l t i a 1 i z e ; Are you sure? Yd!) 
?DUP-I-No bad blocks detected DUx : 

There may be a delay of up to 1 minute while the system scans the diskette 
for bad blocks and creates a new directory. The monitor dot appears when 
this process is complete. 



Now, remove the newly initialized diskette and initialize an adequate num- 
ber of blank diskettes, leaving one initialized, blank, write-enabled ( write- 
protect notch uncovered) diskette inserted in Unit 1 or 2. 
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6.4.2 Formatting and Initializing RX01/RX02 Diskettes 

If you plan to create your working system on RX01 diskettes, initialize a 
number of blank RX01 diskettes. For RX02 diskettes, format and initialize 
the diskettes. Insert a blank diskette in Unit 1. Diskettes are available in 
single-density but not double-density format. Therefore, to create RX02 
diskettes, you must format all your blank diskettes as double-density disk- 
ettes. You can use the FORMAT utility program to format the blank disk- 
ette and the INITIALIZE command to initialize it. Use the /BADBLOCKS 
option with INITIALIZE to cover any bad blocks that may be on your disk- 
ette. If the diskette contains bad blocks, the ?DUP-W-Bad blocks detected 
nnnnnn message appears on the terminal. 

NOTE 

DIGITAL recommends that you use only diskettes that do 
not have bad blocks when you build a working system. To 
ascertain whether an already initialized diskette has bad 
blocks, use the command DIRECTORY/BAD DYn:. You can 
use diskettes with bad blocks later, for working or data vol- 
umes. 

For RX02 diskettes: 

. FORMAT DY1 : (© 

DY1 : /FORMAT-Are you sure? Y(® 
?FQRMAT-I-Fori!iattiriS complete 

, INITIALIZE/BADBLOCKS DY1:@B) 

D Y 1 : / 1 n 1 t 1 a 1 i z e ! Are you sure? Yffl) 
? D U P - I - N o bad blocks detected D Y 1 : 

For RX01 diskettes, just initialize the diskette: 

, INITIALIZE/BADBLOCKS DX1 : ffl) 

DX1 : /Initial ize ! Are you sure? YffiD 

?DUP-I-No bad blocks detected DX1: 

The system scans the diskette for bad blocks and creates a new directory. 
The monitor dot appears when this process is complete. 



Now, remove the newly formatted and initialized diskette. Repeat the pro- 
cess to create as many initialized blank diskettes as you need for the sys- 
tem that you have planned. Leave one diskette in Unit 1. 

6.4.3 Copying the Selected Files onto Diskette 

Use the COPY command with the /SYSTEM option to copy selected files 
from the backup disk to the diskettes that will become your working system 
diskettes. The /SYSTEM option is required for copying .SYS files only if 
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wildcards are used in the input file specification. In the command, yyn is 
the device name and unit number of your backup disk, and xxn is the 
device name and unit numbers of the diskettes to be your working system 
diskettes. 



.COPY 



'n:f ilnauii t'/p x x n s f i 1 n aw.typS 



You can use the following command to avoid typing numerous file specifica- 
tions. RT-11 queries you about all the files on the diskette, and you choose 
the files it copies. 



.COPY/SYSTEM/QUERY yyn: xxn:© 

Files copied: 
y y n : a a a a a a , 1 1 1 to x x n : a a a a a a , 1 1 1 ? 
y y n:bbbbbb.ttt to x x n : b b b b b b . 1 1 1 ? 

(and so on) 



(to include a specific file) 
(to exclude a specific file) 



When you have copied all the files you planned for the working system 
diskette, label the diskette "RT-11 Working System V05 x/y" (where x is 
the diskette number, and y is the number of diskettes in your working 

system). 



6.5 installing the Bootstrap on Any Diskettes That Need to Be 
Bootabie 

Once you have created your working system diskettes, you need to install 
the bootstrap on any diskettes that must be bootable (that is, that you can 
use as system diskettes). Generally, any diskette that includes a monitor 
file and system device handler should be bootable (but remember that the 
diskette would need SWAP.SYS and, for the SJ monitor, TT.SYS). 

Insert the diskette on which you need to install the bootstrap. In the com- 
mand, xxn represents the device name and unit number of your diskette, 
and aa is BL, SJ, FB, or XM. 

•COPY/BOOT xxn:RTllaa.SYS xxn:(H) 



In this command, you need to identify the device on which the monitor that 
contains the bootstrap information resides, the name of that monitor file, 
and the device on which you need to install the bootstrap. This command 
copies bootstrap information from the monitor file to blocks and 2 through 
5 of the same diskette. 

Then, insert working system diskette 1 in Unit 0, and boot your working 
system. Use the hardware bootstrap if possible. If not, type the following 
command; xxn represents the diskette to boot. 
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. BOOT xxn:iffl 
RT-llaa VOS.xx 

(Followed by any start-up file commands.) 



Store your updated backup distribution disk for future updates. 



6.6 Customizing the System 

You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 6.10.) 

6.7 Compressing Each Diskette 

DIGITAL recommends that you compress each working system diskette to 
make its free space contiguous. Consolidating free space allows you to use 
space on the diskette that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit 0, and use the SQUEEZE command to 
compress free space. The squeeze operation does not move files with the 
.BAD file type. 

. SQUEEZE xxO:© 

x x : / S s u e e z e i Are you sure? Y SED 

There is a delay while the squeeze operation takes place. 

RT-l laa U 5 . xx 

(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system diskette. 
Then, insert the next diskette that you need to compress in Unit 1. 

• SQUEEZE xxl:®) 

x x 1 : / S q u e e z e i Are you sure? Y(heD 



Replace the diskette in Unit 1 with the next one you need to compress, and 
repeat this procedure for all the diskettes. 
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NOTE 

When you compress a diskette with system files (.SYS), PIP 
warns you to reboot. Do reboot as advised. When you com- 
press a system diskette, the system automatically reboots. 



6.8 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files and preserve the system on backup diskettes. 

Use the following command to protect all the files on the system diskette: 

.PROTECT/SYSTEM *.*(© 

Files protected: 
DK:aaaaaa.ttt 
DK: bbbbbb. ttt 
DK:cccccc.ttt 
DK : dddddd .ttt 



DK:zzzzzz.ttt 



To protect files on other diskettes in the working system, insert each disk- 
ette in Unit 1 and use the following command: 

.PROTECT/SYSTEM xxl:*.#® 

Files protected: 
xxi:aaaaaa.ttt 
x x 1 : b b b b b b » 1 1 1 
xxl :cccccc.ttt 
x x 1 : d d d d d d . 1 1 1 



zzzzzz.ttt 



Next, copy the working system to backup diskettes. Insert a blank diskette 
in Unit 1 with RT-11 still booted from Unit 0. Format (if you are using 
RX02 diskettes) and initialize the appropriate number of diskettes. 

Copy all the files in your working system. You can use the 
SQUEEZE/OUTPUT:xxl: xxO: command to copy any bootable diskettes. 
Remember that you must use SQUEEZE/WAIT/OUTPUT:xxl: xxO: and 
change diskettes to copy the diskettes that are not bootable. (Refer to Sec- 
tion 3.4.) Also remember to copy the bootstrap to any diskettes that need 
to be bootable. 

Store the backup working system diskettes. If you ever need to restore the 
working system, you can make copies of the backup working system disk- 
ettes. 
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6.9 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL' considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 
RT11FB.SYS 

xx. SYS (system device handler) 
LP.SYS 
EDIT.SAV 
MACRO.SAV 
) SYSMAC.SML 

LINK.SAV 
PIP.SAV 
DUP.SAV 
DIR.SAV 
DEMOBG.MAC 
DEMOFG.MAC 

j Insert a blank diskette in Unit 1. If you are using RX02 diskettes, format 

the disk first. 

. .FORMAT DY1 :® 

DY1 :/FORMAT-Are you sure?Y© 
?FORMAT-I-For matt ins complete 

Initialize all diskettes, and check for bad blocks. 

^ .INITIALIZE/BADBLOCKS xxl : (® 

? x x 1 : / I n 1 1 i a 1 i 2 e i A r e >• o u s u r e ? Y@) 

?DUP-I-No bad blocks detected xxl: 

.ASSIGN xxl : DK:(H) 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 
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DIRECTORY/BRIEF/COLUMNS: 1 SY:® 

d d - in in iii - v y 



SWAP 


.SYS 


RT1 1FB 


.SYS 


LP 


, SYS 


A A 


.SYS 


EDIT 


. SAV 


MACRO 


. SAV 


SYSMAC 


.SML 


LINK 


. SAV 


PIP 


.SAM 



xxx Files ) bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s ) to stop the display and 
(ctrl/q) to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 

6.9.1 Preparing the Background Demonstration Program 

6.9.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

.EDIT SY: DEMOBG.MAC© 

*F5(H.ASCII( 

*0ADiD(iiE) 

*E> 



6.9.1.2 Assemble the Background Demonstration Program — The background 
program, DEMOBG.MAC, is an assembly language source file; it must be 
assembled and linked before you can execute it. To assemble DEM- 
OBG.MAC and obtain a listing, make sure that your configuration has a 
line printer that is on-line and ready. 

.ASSIGN LP: LST:© 
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NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

• ASSIGN TT: LSTs© 



Assemble DEMOBG.MAC as follows: 

• MACRO/LIST:LST: SY : DEMOBG© 

(See Figure 6-2.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

• RENAME SY:DEMOBG.BAK SY : DEMOBG . MAC© 



Figure 6-2: DEMOBG Assembly Listing 



DEMOBG MACRO V.'05.01b Friday 05-D*c-B3 10:16 Page l 



000000 
0000.J1 

oooo-i :■ 


000 777 


000044 
000052 
00010 6 


000207 


0001.10 


007 


00011? 
000117 


1.11 


0001J2 5 


000 


000236 
000242 


000000 



.TITLE DEMOBG 

. IDENT /V05.00/ 
DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE, THEN 
RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVBC- .PRINT 

TART!! .RCVDC tAREA.tBUFFF_R.*100.tM5GIN iPOSl REOUEST FOR MESSAGE 
.PRINT *MSG rPRINT PEMllNSTRA T ION MESSAGE 

BR . (AND LOOP 

COMPLETION ROUTINE ENTERED WHFN FG SENIiS MESSAGE 



bell: 
msg: 



.PRINT 
. RCVDC 

RETURN 



♦ BELL iRING BELL IN RESPONSE I'D MESSAGE 

+AREA,*BUFFER»*400.*HSGIN (POST ANOTHER MESSAGI. RE. QUEST 

SAND RETURN FROM COMPLETION ROUT INF 



ASCII MESSAGE!! 
.NL1ST BEX 
.BYTE 7.200 



(MESSAGE' THAT RINGS BELL 



area: 
buffer: 



.ASCII 
.ASCII 
.ASCII 
.BYTE 

. BLKU A 

-END 



/RT-11 DEMONSTRATION PROGRAM/ \Z 12 
/IF INCORRECTLY ELUTEDf THIS IS THE LAST 
/WELL DONE./ 



iLM'l ARGUMENT AREA 
iftCVMC MESSAGE AREA 



DEMOBG MACRO VQ5.01b Friday 09-Oec-83 10:16 
Symbol table 



AREA 000226R 
BELL 000110R 

. ABS. 000000 
000242 
Errors detected : 



000 
001 



BUFFER 000212R 
MSG 000112R 



(RU.I.GBL, ABS.GVR) 
(RWrl.LCLfREL.CON) 



MSGIN 000014R 
START OOOOOORG 



.VI = 000003 



*** Assembler stati sties 

work file reads! 

Work file writes! 

Size of work fil«: 9188 words ( 36 Pages) 

Size of core pool: 1A12B Uords < 63 Pases) 

Opera tins ssstem! RT-11 

Elapsed time! 00:00:05.4S 

HK ! DEMOBG t DK I DEMOBG=DK ! DEMOBG 
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6.9.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG.OBJ to produce an executable background program, DEM- 
OBG.SAV. 

• LINK DEMOBG®) 



6.9.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 



-RUN DEMOBGdD 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE. 

WELL DONE. 



If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

(CTRU C ) 
[CTRl/C) 



If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

.RENAME DEMOBG. BAK DEMOBG . MAC© 



Then, repeat the editing procedure. 



6.9.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and execute it in conjunction 
with DEMOBG.SAV. DEMOFG.MAC is a small foreground program that 
sends a message every 2 seconds to DEMOBG (running in the background), 
telling it to ring the terminal bell. DEMOBG recognizes these messages 
and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 
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6.9.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

. MACRO/LIST:LST: SY : DEMOFG© 



The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your data volume (DK). 

6.9.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

.LINK/FOREGROUND DEMOFGdD 



6.9.2.3 Run the Foreground and Background Demonstration Programs — Type 
the following command to load and start DEMOFG.REL as the foreground 
job. 

. FRUN DEMOFG© 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EMERY Z SECONDS. TELLING IT TO RING THE BELL. 



(CT RTJb"] 



DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG. SAV in the background and re- 
ceive the messages. 

.RUN DEMOBG© 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED) THIS IS THE LAST LINE. 

WELL DONE, 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 



(CTRL, c ) 

(CTRl/C) 

(The bell stops ringing, i 

.DIRECTORY© 

d d - m m w - v y 

(The directory of the device DK prints on the terminal.) 
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Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

• RUN DEMOBG© 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE, 

WELL DONE. 



(CTRL/C) 
(CTRL/C) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 

(CTRl/F ) 

F> 
(CTRL/C i 

iCTRL/C) 
B> 

UNLOAD F@) 



If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

6.10 Performing the System Generation Process 

If you have decided that you need RT-ll features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-ll System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 7 

Installing a System Distributed on RX02 to Run on 
RX02 



If RT-ll was distributed to you on RX02 double-density diskette, and you 
intend to build a system to run on double-density diskette, perform the 
procedures described in this chapter. 

Your distribution kit contains two exact copies of the RT-ll operating 
system on RX02 diskettes. Store one copy of the RX02 diskettes in a safe 
place, and do not modify their contents; they provide a backup (master) 
copy of the distributed RT-ll operating system. 

) Store the second copy of diskettes in a safe place after installing software 

updates and creating your working system diskettes. Use these diskettes to 
create another working system. If these diskettes are ever damaged, use 
the master copy to reproduce them. 

NOTE 

If your hardware configuration includes a VT100 terminal, 

be sure to set AUTO XON/XOFF in SETUP mode B before 

\ attempting to bootstrap RT-ll. Never set TT NOPAGE when 

you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, perform the steps summarized in the following list. 
Sections 7.1 through 7.9 describe the procedures involved in each step. 
Figure 7-1 shows the diskettes you create when you install RT-ll. 

1. Bootstrap the distribution diskette. 

2. Install software updates. 

3. Create the working system from chosen components. 

4. Install the bootstrap on diskettes that need to be bootable. 

5. Customize the system. 
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6. Compress each diskette. 

7. Preserve the working system. 

8. Test the working system. 

9. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 7-1: Sample Backup Diskettes 



RX02 BACKUP 

DISKETTES 

(MASTER) 



INSTALL UPDATES 



RX02 

DISTRIBUTION 

DISKETTES 




BACKUP 
WORKING 
SYSTEM 
DISKETTES 



5TORAGE CABINET 



7=1 Bootstrapping the Distribution Diskette 

The first procedure you perform when installing RT-11 is to bootstrap dis- 
tribution diskette 1. 

Begin by making sure that the processor is powered up but not running. 
Insert the distribution diskette labeled 1 in Unit (which has the physical 
device name DYO:). Use the hardware bootstrap to boot the diskette. (If 
your configuration does not include a hardware bootstrap, see Appendix B 
for toggle-in software bootstraps.) 

RT-11 should respond with the following message if you have successfully 
bootstrapped the diskette: 
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RT-1 1FB V05.XX 
.TYPE M5USER.TXT 

RT-1 1 U 5. kx 



installation of RT-ii ....(followed by V5USER.TXT message) 



After you boot the system, you can create a start-up file containing any 
commands or sequence of commands that you would normally want to exe- 
cute at the start of each terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can 
execute it with the (a command, so that the commands it contains become 
effective. 

Next, remove the protection from all the files on the distribution diskettes. 
The files on the distribution diskettes have been protected to prevent you 
from accidentally deleting them. (Refer to the RT-11 System User's Guide 
for a description of file protection.) (Note the P that prints next to the file 
size in the directory.) For the rest of these procedures, you need to remove 
the protection from these diskettes. Type the following command to remove 
it from the files on distribution diskette 1: 

• UNPROTECT/SYSTEM *,*<m 

Files unprotected: 
DK:aaaaaa.ttt 
DK : bbbbbb . ttt 
DK:cccoco.ttt 
DK:dddddd. ttt 



DK'szzzzzz.ttt 



Insert distribution diskette 2 in Unit 1 and type the following command: 

•UNPROTECT/SYSTEM DY1:*.*(H> 
Files unprotected: 

DY1 : aaaaaa. ttt 
DY1 : bbbbbb. ttt 
DYl:cccccc.ttt 
DY1 : dddddd. ttt 



DYl:zzzzzz.ttt 
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Replace distribution diskette 2 with distribution diskette 3 in Unit 1 and 
repeat this command. In the same way, remove protection from the files on 
the remaining distribution diskettes. 

7.2 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
base system and contain modules for both base system and layered prod- 
ucts. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

7.3 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3) and have 
planned the best arrangement of them on diskettes (Section 2.4), you can 
create the working system by copying selected components to formatted 
and initialized blank diskettes. 

Start by formatting and initializing a number of blank diskettes. Insert a 
blank diskette in Unit 1 so you can format and initialize it. Diskettes are 
available in single-density but not double-density format. Therefore, you 
must reformat all your blank diskettes as double-density diskettes. You can 
use the FORMAT utility program, which is included on distribution disk- 
ette 1, to format the blank diskettes and the INITIALIZE command to 
initialize them. Use the /BADBLOCKS option with INITIALIZE to cover 
any bad blocks that may be on your diskettes. If a diskette contains bad 
blocks, the WUP—W—Bad blocks detected nnnnnn message appears on the 
terminal. 

NOTE 

DIGITAL recommends that you use only diskettes that do 
not have bad blocks when you build a working system. To 
ascertain whether an already initialized diskette has bad 
blocks, use the command DIRECTORY/BAD DYn:. You can 
use diskettes with bad blocks later for working or data vol- 
umes. 
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, FORMAT DY1 :© 

DY1 : /FORMAT- A re you sure? Y© 
?FORMAT-I-For mat t in 3 complete 

, INITIAL IZE/BADBLOCKS DY1 :© 

D Y 1 ; / I n i t i a 1 1 z e ! Are you sure? Y© 
?DIJP-I-No bad blocKs detected DY1: 

The system scans the diskette for bad blocks and creates a new directory. 
The monitor dot appears when this process is complete. 



Repeat the process to create as many initialized blank diskettes as you need 
for the system that you have planned, leaving one initialized, blank disk- 
ette in Unit 1. 

Then, use the COPY command with the /SYSTEM option to copy selected 
files from distribution diskette 1 to the diskette that becomes your working 
system diskette. The /SYSTEM option is required for copying .SYS files 
only if wildcards are used in input file specifications. 

.COPY D YO : f i 1 n aw 1 1 y p D Y 1 : f i 1 n am . t •/ p© 



You can use the following command to avoid typing numerous file specifica- 
tions. RT-11 queries you about all the files on the diskette, and you choose 
the files it copies. 



.COPY/SYSTEM/QUERY DYO: DYls© 

Files copied: 
D YO : a aaaaa • 1 1 1 to DY 1 : aaaaaa . 1 1 1 ? Y© 
DYO : b b b b b b , 1 1 1 to D Y 1 : b b b b b b . 1 1 1 ? N© 

(and so on) 



(to include a specific file) 
(to exclude a specific file) 



To copy files from nonbootable diskettes, you have to alternate diskettes. 
Use the SET command to set the USR to NOSWAP. 

.SET USR NOSWAP© 



Type the following command, where filnam.typ is the name of the file you 
want to copy. In this case, you cannot use the /QUERY option; you must 
specify individual files. 

.COPY/WAIT DYlrf ilnam.typ DYO : f i lnam . t y p© 

M o u n t inp u t u o 1 u m e in D Y 1 : i C o n t i n u e ? 

Place the diskette containing the file you want to copy in Unit 1. 
Y© 

M o u n t outp u t vol u w e in D Y : ! C o n t i n u e ? 
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Replace the system diskette in Unit with the diskette to which you want 
to copy filnam.typ. 

M o u n t s v s t e hi y o 1 u in e in D Y : i C o n t i n u e ? 

Replace the diskette in Unit with backup diskette 1. 



Repeat this procedure to copy all the files you planned for the working 
system diskette. When you have copied all the files, label the diskette 
"RT-11 Working System V05 1". Repeat these procedures to create the 
other diskettes in the working system. 

When you have created and labeled all the working system diskettes, you 
can permit the USR to swap again. 

,SET USR SWAP® 

7.4 Installing the Bootstrap on Any Diskettes That Need to Be 
Bootable 

Once you have created your system, you need to install the bootstrap on 
any diskettes that must be bootable (that is, that you can use as system 
diskettes). Generally, any diskette that includes a monitor file and system 
device handler should be bootable (but do not forget that the diskette would 
need SWAP.SYS and, for the SJ monitor, TT.SYS). 

Insert in Unit 1 the diskette on which you need to install the bootstrap. In 
the command, aa is BL, SJ, FB, or XM. 

.COPY/BOOT DY1 :RTllaa.SYS DY1:(H) 

In this command, you identify the device on which the monitor that con- 
tains the bootstrap information resides, the name of that monitor file, and 
the device on which you need to install the bootstrap. This command copies 
bootstrap information from the monitor file to blocks and 2 through 5 of 
the same diskette. 

Then, insert working system diskette 1 in Unit 0, and use the hardware 
bootstrap to boot your working system. 

RT-llaa V05.xx 

(Followed by any start-up file commands.) 

Store the updated distribution diskettes for future updates. 
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7.5 Customizing the System 



You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 7.9.) 



7.6 Compressing Each Diskette 

DIGITAL recommends that you compress each working system diskette to 
make its free space contiguous. Consolidating free space allows you to use 
space on the diskette that would otherwise be too fragmented to be usable. 

Continue to run RT-11 from Unit and use the! SQUEEZE command to 
compress free space. The squeeze operation does not move files with the 
.BAD file type. 

• SQUEEZE DYO:(H) 

DYO: /Squeeze! Are you sure -7 Y(RET) 

There is a delay while the squeeze operation takes place. 

RT-11 xx U05,xx 

(Followed by any start-up file commands.) 



The system automatically reboots when you compress a system diskette. 
Then insert the next diskette that you need to compress in Unit 1. 

.SQUEEZE DY1 : (© 

D Y 1 : / S q u e e z e i Are you s u r e ? Y (S3) 



Replace the diskette in Unit 1 with the next one you need to compress, and 
repeat this procedure for all the diskettes. 

NOTE 

When you compress a diskette with system files (.SYS), PIP 
warns you to reboot. Do reboot as advised. When you com- 
press a system diskette, the system automatically reboots. 
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7.7 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files and preserve the system on backup diskettes. 

Use the following command to protect all the files on the system diskette: 

•PROTECT/SYSTEM *,*(H) 

Files protected: 
DK:aaaaaa t ttt 
DK:bb bbbb . ttt 
DK:ccccoc.ttt 
D K : d d d d d d . 1 1 1 



DK : zzzzzz . t tt 



To protect files on other diskettes in the working system, insert each disk- 
ette in Unit 1 and use the following command: 

, PROTECT/SYSTEM DY1 :*.*© 

Files protected: 
DYl:aaaaaa.ttt 
DY1 : bbbbbb , ttt 
DYl:cccccc.ttt 
D Y 1 : d d d d d d . 1 1 1 



DYl:zzzzzz.ttt 



Next, copy the working system to backup diskettes. Insert each blank disk- 
ette in Unit 1 with RT-11 still booted from Unit 0. Format and initialize 
the appropriate number of diskettes. 

Copy all the files in your working system. You can use the 
SQUEEZE/0UTPUT:DY1: DYO: command to copy any bootable diskettes. 
Remember that you must use SQUEEZE/WAIT/0UTPUT:DY1: DYO: and 
change diskettes to copy the diskettes that are not bootable. Also remember 
to copy the bootstrap to any diskettes that need to be bootable. 

Store the backup diskettes. If you ever need to restore the working system, 
you can make copies of the backup working system diskettes. 



7.8 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
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major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP. SYS 

RT11FB.SYS 

DY.SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Insert a blank diskette in Unit 1. 

.FORMAT DY1 : EH) 

DY1 : /FORMAT-Are you sure' YGD 
?FORMAT-I-ForitiattinS complete 

.INITIALIZE/BADBLOCKS DY1:(H) 

D Y 1 : / I n i t i a 1 1 z e i Are you sure? Y© 

?DUP-I-No bad blocks detected DY1: 

.ASSIGN DY1 : DK:dB 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 



.DIRECTORY/BRIEF/COLUMNS: 1 SY: 


d d - w m m - y y 


SWAP 


.SYS 


RT1 1FB 


, SYS 


LP 


, SYS 


DY 


.SYS 


EDIT 


.SAY 


MACRO 


.SAM 


SYSMAC 


-SML 


LINK 


.SAM 


PIP 


. SAU 



xxx Files* bbb Blocks 
f f f Free blacks 
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NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s ) to stop the display and 
[ctrl/q) to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 

7.8.1 Preparing the Background Demonstration Program 

7.8.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

* EDIT SYrDEMQBG.MAC® 
*Fi(ID.ASCII®® 

* OAD®® 

* EX®® 

7.8.1.2 Assemble the Background Demonstration Program — The background 
program, DEMOBG.MAC, is an assembly language source file; it must be 
assembled and linked before you can execute it. To assemble DEM- 
OBG.MAC and obtain a listing, make sure that your configuration has a 
line printer that is on-line and ready. 



ASSIGN LP: LST: 



NOTE 



If your configuration does not include a line printer, use the 
console terminal. 



ASSIGN TT; LST:I 



Assemble DEMOBG.MAC as follows: 

• MACRO/LIST:LST: SY : DEMOBG® 

(See Figure 7-2.) 



If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

•RENAME SY:DEMOBG.BAK SY : DEMOBG . MAC© 
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Figure 7-2: DEMOBG Assembly Listing 



OENOBCi MACRO V05.01b Friday 09-Dec-63 10:16 Page 



000000 
000 034 

000011' 000777 



O00011 
0000^2 
O00I0* 0OO2O7 



?o oooi io 



oooi in i:t 

000147 1 1 I 



ooo:.'.?6 

OOO'.'ID 



104 



.TITLE DEMOBG 

.IBENT /V05.00/ 
DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE. THEN 
RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCUDC, .PRINT 

TART!! .RCVDC *AREAr*&UFF£R,*400.tMSGIN iPOST REOUEST FOR MCSSAGF- 
. PRINT *MSG JPRINT DEMONSTRATION MFS^AOF 

BR . ;ANIi L OOF- 

COMPLETION ROUTINE ENTERED WHEN FG SENDS MESSAGE 

SGIN: .PRINT *BELL (RING BELL IN RESPONSE HI MESSAGE 

.RCUDC *AREA>*BUFrER>*400r*MSGIN SPOSf ANOTHER MKSSAGI. RLQUEST 
RETURN fAND RETURN FROM CIJMPLL 7 ! I ON RI'JLMINt 



BELL I 

msg: 



ASCII MESSAGES 
.NLISf BEX 
.BYTE 7,200 



■ MESSAGE THAT RINGS Bt.Ll 



.ASCII /RT-11 DEMONSTRATION PROGRAM/ 

.ASCII /IF INCORRECTLY EU E TED, THIS IS 

•ASCII /WELL DONE./ 

.BYTE 



1HE LAS1 1. INL . >' !', 



AREA : 

buffer: 



, BLKU 6 

.END START 



itMT ARGUMENI ARfcA 
fRCVhC MESSAGE area 



DEMOBG MACPO V05.01b Friday 
Symbol tahlP 



09-Dec-83 10:16 Page 1-1 



ARFA 000.-2AR 

PELL 000110ft 

. AHS. 000000 
000242 
Is mans dptect.t'd: 



BUFFER 
MSG 



0002 4 2R 
000112R 



MSGIN 000044R 
SI ART OOOOOORG 



000 

001 



(RU,IiliRLtABS»OVR> 
(RU,IrLCL»REL»CON) 



*** Assembler stat t -itic-s 

Mori- file reads : 

No i* file write! 

Size of work file! 9.1 08 Words 

Kiss of cure f0 oi: 1A128 Words 

Opei-atina system! RT-11 

E 1 3r <ied Ume ! 00:00:05.45 

UK J DEMOBG fDKIDEMUBG-rm: DEMOBG 



( 36 Pases) 

< 63 PaSes) 



. . .VI • 000003 



.V2 0000." 



7.8.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG. OBJ to produce an executable background program, DEM- 
OBG.SAV. 

LINK DEMOBG© 



7.8.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 

,RUN DEMOBGtH) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

(CTRL/C) 
(CTRLC) 



If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

.RENAME SY: DEMOBG. BAK SY : DEMOBG , MAC© 

Then, repeat the editing procedure. 
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7.8.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program DEM- 
OFG.MAC, link it for the foreground, and execute it in conjunction with 
DEMOBG.SAV. DEMOFG.MAC is a small foreground program that sends 
a message every 2 seconds to DEMOBG (running in the background), tell- 
ing it to ring the terminal bell. DEMOBG recognizes these messages and 
rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

7.8.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

• MACRO/LIST:LST: SYrDEMOFGffl) 



The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your data volume (DK). 

7.8.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

•LINK/FOREGROUND DEMOFG© 



7.8.2.3 Run the Foreground and Background Demonstration Programs — Type 
the following command to load and start DEMOFG.REL as the foreground 
job. 

• FRUN DEMOFG© 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEMOBG 

EMERY 2 SECONDS. TELLING IT TO RING THE BELL. 

B> 
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DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG.SAV in the background and re- 
ceive the messages. 

.RUN DEMOBG®) 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 

ICTRL/C ] 
(CTRL/ C ) 

(The bell stops ringing.) 

.DIRECTORY© 

d d - m m in - y v 
(The directory of the device DK prints on the terminal.) 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

.RUN DEMOBGdTJ 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

NELL DONE, 

(CTRL/c) 



\ (CTRL/C ] 



(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 



SCTRL,' F ) 

F .■■ 

iCTRL/C) 
i CTRL/C) " 
B> 

UNLOAD FdD 



If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 
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7.9 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-11 System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 8 

Installing a System Distributed on Magtape to Run 

on Hard Disk 



If RT-ll was distributed to you on magtape, and you intend to build a 
system to run on hard disk, perform the procedures described in this chap- 
ter. These procedures assume that your configuration includes only one 
disk drive. With two disk drives, you still have to perform the logical steps 
summarized in the following list; however, you can simplify some proce- 
dures by using the additional disk drive. Sections 8.1 through 8.11 describe 
the procedures involved in each step. Figure 8-1 shows the various backup 
magtapes you create when you install RT-ll. 

NOTE 

If your hardware configuration includes a VT100 terminal, 
be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-ll. Never set TT NOPAGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

1. Bootstrap the first distribution magtape. 

2. Preserve both distribution magtapes. 

3. Install software updates. 

4. Create updated master magtapes. 

5. Create the working system on the disk from chosen components. 

6. Install the bootstrap on the disk. 

7. Customize the system. 

8. Compress the disk. 

9. Preserve the working system. 



8-1 



10. Test the working system. 

11. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 8-1: Sample Backup Magtapes 




COPY AFTER 
DELETING 
UNNEEDED 
COMPONENTS 
FROM DISK 



STORAGE CABINET 



BACKUP WORKING 
SYSTEM MAGTAPE 



8.1 Bootstrapping the First Distribution Magtape 



The first procedure you perform when installing RT-11 is to bootstrap the 
first distribution magtape. 

Begin by making sure that the processor is powered up but not running. 
Mount the distribution magtape labeled 1/2 (remove the write ring from the 
back of the tape reel). Manually position the magtape at the load point if 
the magtape is not in this position. 

If your system has a hardware bootstrap capable of bootstrapping the mag- 
tape, boot the tape and proceed. If not, use the appropriate toggle-in soft- 
ware bootstrap in Appendix B. 

The magtape moves as the primary bootstrap loads the secondary bootstrap 
file MSBOOT.BOT. 

MSBOOT responds on the terminal. 

MSBOOT UOx-yy 
* 

The next step depends on whether you have a TM11 or TJU16 as a magtape 
device. If you have a TM11, use the magtape build program named 
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MDUP.MT. If you have a TJU16, use the magtape build program named 
MDUP.MM. 

MDUP.MT (HI 



or 

MDUP.MMdlD 

The magtape moves as the specified MDUP program is loaded. 

MDUP VOx . yy 
* 

The next procedure is to build a minimal system on the disk. Start by 
initializing the system disk. If your disk is an RK05, be sure to use a 
formatted disk. 

You need to initialize the system disk and scan it for bad blocks before you 
can copy system files to it. You specify these operations to MDUP by enter- 
ing the device name followed by combinations of the following options. 

/Z to initialize the disk 

/B to scan it for bad blocks 

Mount a formatted disk (write-enabled). 

Use the following command, where xx is the permanent device name (RK, 
DL, DM, DP, or DU) for your disk. 

xxO: /Z/B(© 

The system scans the disk for bad blocks and creates a directory. 



Now you can build a minimal system on the disk. Depending on the type of 
tape drive you have, use one of the two following commands (where xx is 
the permanent device name for your disk). 

If the magtape is TM11: 

xxO:A = MTO:iS) 

If the magtape is TJU16: 

xxO: A = MMO:(H) 

The tape moves while the system copies the monitor, swap file, system 
device handler, terminal handler, line printer handler, magtape handler, 
PIP, DUP, and DIR to the disk. When the files are copied, MDUP boots the 
minimal system from the disk. 
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RT-11SJ i,'05.xx 
?KMDN-F-Com(iiand file not found 



You are now running from the minimal system on the disk. This minimal 
system supports enough file maintenance commands to allow you to com- 
plete the building process. 

NOTE 

MDUP does not support automatic replacement of bad blocks 
for RK06, RK07, RL01, and RL02 disks. If your disk is an 
RK06, RK07, RL01, or RL02 and you want automatic bad 
block replacement, you must initialize a second disk and copy 
your files to it at a later time. 

If you wish to set the date and time, use the DATE command to set the date 
(where dd-mmm-yy is the day, month, and year in the form 10-JAN-83); 
use the TIME command to set the time (where hh:mm:ss is the hour, min- 
utes, and seconds). 

•DATE dd-mmm-yyffl) 
-TIME hh :mm: ss© 



Now copy the rest of the files from distribution magtape 1 to the disk. Use 
the following command, where xx is MT or MM. 

•CDPY/SYSTEM/NOREPLACE xxO:*,* DK:@H) 

Files copied: 
xxO:aaaaaaittt to DK:aaaaaa.ttt 



xx0:zzz2zz.ttt to DK:zzzzzz.ttt 
?PIP-W-Reboot 



NOTE 



You must use the /NOREPLACE option in this command, so 
that the files you copied to the disk when you built the mini- 
mal system will not be copied again. The system prints a 
message to tell you which files it does not copy (for example, 
SWAP.SYS not copied). 



Reboot as advised. 
-BOOT SY:(H) 



8.2 Preserving Both Distribution Magtapes 

Copy both distribution magtapes for backup, as a safety measure in case of 
machine failure or human error. To back up the magtapes, complete the 
following steps: 



8~4 Installing a System Distributed on Magtape to Run on Hard Disk 



1. Replace distribution magtape 1 in the tape drive with a blank magtape. 

) 2. Copy all the distribution files from the disk to the blank backup mag- 

tape. 

3. Replace the backup magtape with distribution magtape 2. 

4. Copy everything from distribution magtape 2 to disk. 

5. Replace distribution magtape 2 with a blank magtape. 

6. Copy those files that were on distribution magtape 2 from the disk to 
the blank backup magtape 2. 

Step 1 

Remove distribution magtape 1 and mount a blank magtape on the tape 
drive. Leave the write ring in the back of the reel, and make sure that the 
tape is positioned at the load point. 

) Step 2 

Copy all files from the disk to the magtape by invoking the indirect com- 
mand file DISMT1.COM (procedure follows). DISMT1.COM initializes the 
blank magtape, writes the primary bootstrap on it, and copies a duplicate of 
distribution magtape 1. Before you invoke this indirect command file, use 
the ASSIGN command to assign the logical name DIS: to your disk device 
and the logical name TAP: to your tape drive. In the commands, x-x is MT or 
MM, and yy is your disk. 

.ASSIGN xxn: TAP:© 

.ASSIGN v/n: DIS:© 

.0DISMT1© 

(The commands in the indirect file print on the terminal.) 

Step 3 

Rewind the newly created backup magtape, remove it, and label it "Backup 
RT-11 V05 1/2". 

) Remove the write ring from the back of distribution magtape 2, if neces- 

sary, and mount the reel. 

Step 4 

Copy all files from distribution magtape 2 to the disk. Use the following 
command, where xx is MT or MM. 

.COPY/SYSTEM/NDREPLACE xxO:*.* DK:(H) 

Files copied: 
xxO:aaaaaa.ttt to DK:aaaaaa.ttt 



xxO:zzzzzz.ttt to DK:zzzzzz,ttt 
?PIP-W-Reboot 



Reboot the disk. 
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Step 5 

Rewind the distribution magtape and remove it. Mount another blank mag- 
tape, leaving the write ring in the back of the reel. Make sure that the tape 
is positioned at the load point. 

Step 6 

Use the indirect command file DISMT2.COM to initialize the magtape and 
then to duplicate the copies of files from distribution magtape 2 on the 
newly initialized blank magtape (procedure follows). Note that this tape is 
not a bootable magtape. Use the ASSIGN command to assign the logical 
name DIS: to your disk device and the logical name TAP: to your tape 
drive. In the commands, xx is MT or MM, and yy is your disk. 

• ASSIGN xxn: TAP:© 

• ASSIGN vvn: DIS: (SB) 
- @DISMT2@H) 

(The commands in the indirect file print on the terminal.) 

Then, rewind the newly created backup magtape, remove it, and label it 
"Backup RT-11 V05 2/2". 

Store the distribution magtapes. 

8.3 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Updated modules are critical to system or com- 
ponent operation. They correct software errors discovered since the last 
release, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the distribution medium to your 
system, using the procedures described in the RT-11 Update User's Guide. 
Updates are distributed on the same medium on which you received the 
base system and contain modules for both base system and layered prod- 
ucts. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
serious problems and may contain suggested solutions to problems, until 
the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

8.4 Creating Updated Master Magtapes 

Once you have installed updates in the components you copied to the disk, 
copy all the files to blank magtapes. These magtapes can serve as updated 
masters. As other mandatory updates are published, you can copy the af- 
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fected component from the updated master magtape to the disk, install the 
update, and copy the file back to the updated master. In this way, you can 
make sure that you have up-to-date versions of all RT-11 components, even 
if your working system is destroyed. 

Mount another blank magtape, leaving the write ring in the back of the 
reel. Make sure that the tape is positioned at the load point. 

Use the following procedures to initialize the magtape and copy the same 
files to updated master magtape 1 as you copied to backup magtape 1 (in- 
cluding the bootstrap) and the same files to updated master magtape 2 as 
you copied to backup magtape 2. In the commands, xx is MT or MM, and yy 
is your disk. 

'ASSIGN xxn: TAP:© 

'ASSIGN yyn: DIS:© 

'@DISMT1© 

(The commands in the indirect file print on the terminal.) 

Rewind the newly created magtape, remove it, and label it "Updated Mas- 
ter RT-11 V05 1/2". Mount another blank magtape, leaving the write ring 
in the back of the reel. Make sure that the tape is positioned at the load 
point. 

Use the following procedures to initialize the magtape and copy the same 
files (now updated) to this magtape that you copied to backup magtape 2. In 
the command, xx is MT or MM, and yyn is your disk. 

'ASSIGN xxn: TAP:© 

•ASSIGN yyn: DIS:© 

•0DISMT2© 

(The commands in the indirect file print on the terminal.) 



Then, rewind the newly created magtape, remove it, and label it "Updated 
Master RT-11 V05 2/2". 

Store the two updated master magtapes, and use them when you install 
any future software updates. 



8.5 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3), backed up the 
distribution magtapes, and created updated masters, you can create the 
working system by deleting unneeded components from the disk. 

The following command queries you about all the files on the disk. Choose 
the files you want to delete. 



'DELETE/SYSTEM/QUERY *,*(! 
Files deleted: 

DK:aaaaaa.ttt' 

DK: bbbbbb . ttt' 

(and so on) 



Y© 
N© 



(to delete a specific file) 
(to retain a specific file) 
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8.6 Installing the Bootstrap on the Disk 

Once you have created your working system, copy the bootstrap from the 
monitor file of your choice (RT11BL, RT11SJ, RT11FB, or RT11XM) to the 
disk. In the command, xx is the permanent device name for your disk, and 
aa is BL, SJ, FB, or XM. 

.COPY/BOOT xxO:RTl laa.SYS xxO:© 



Then, halt the processor, and use the hardware bootstrap to boot the work- 
ing system disk. 

RT-llaa V05. xx 

(Followed by any start-up file commands.) 



NOTE 

If the disk does not boot, repeat the procedures to this point. 

8.7 Customizing the System 

You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarizes the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 8.11.) 

8.8 Compressing the Disk 

DIGITAL recommends that you compress the working system disk to make 
its free space contiguous. Consolidating free space allows you to use space 
on the disk that would otherwise be too fragmented to be usable. 

Use the SQUEEZE command for this procedure. (The disk must be write- 
enabled.) The squeeze operation does not move files with the .BAD file type. 
In the command, xx is the device name for your disk. 

.SQUEEZE xxn:®) 

xxn : /Squeeze i Are you sure' Y@D 

RT-1 laa V05 . xx 

(Followed by any start-up file commands.) 

The system automatically reboots when you compress a system disk. 
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8.9 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files in it and preserve the system on the backup me- 
dium of your choice. 

Use the following procedures to back up the disk on magtape. First, protect 
all the files on the disk. 

.PROTECT/SYSTEM * , *fni.V 

F ; 1 e s protected: 
DK:aaaaaa.ttt 
DK : bbbbbb , ttt 
DK:cccccc.ttt 
DK:dddddd, ttt 



DK:zzzzzz.ttt 



Next, initialize another blank magtape and copy files to it. You may be able 
to fit the working system on one backup magtape. You can place approxi- 
mately 3000 blocks on a 600 foot 800 bits/in magtape. 

Mount a blank magtape, leaving the write ring in the back of the reel. 
Make sure that the tape is positioned at the load point. Use the following 
command, where xx is MT or MM: 

. I H i T I AL I ZE/F I LE : MBOGT , BOT x xO : llE 
x x : / I n i t l a 1 i z e ! Are you sure? Y fRETi 



Then, copy all the files from the disk to the magtape, in the order shown. 
Essentially, you should use the following procedure whenever you build a 
bootable magtape. If you do not copy the files in this order, bootstrapping 
the magtape will be a painfully long process. Keep track of all the files you 
copy, so that when you copy the rest of the files, you will know which files 
you have already copied. If you have deleted some device handlers from the 
system, the log that prints on the terminal will not include the deleted 
device handlers. 

The following COPY procedure shows a log from a system that includes all 
the device handlers. In the commands, xx is MT, MM, or MS, and aa is BL, 
SJ, FB, or XM. 

•COPY MSBD0T.B0T xxO : MSB00T . BOT/ POSITION :- 1(H) 

• COPY/SYSTEM MDUP.* xxO : MDUP .*/ POSITION :- 1© 
Files copied: 

DK:MDUP.MM to xx0:MDUP.MM 
DK:MDUP.MT to xxO:MDUP,MT 
DK:MDUP.MS to xxO:MDUP.MS 

• COPY SWAP. SYS xx0:SWAP . SYS/ P0S I T I ON : -1(H) 

• COPY RTllaa.SYS x xO : RT 1 1 aa . SYS/ P0S I T I ON : - 1 (H) 
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• COPY TT.SYS xxO:TT.SYS/POSITIDN:-l(g0) 

•COPY/SYSTEM DM. SYS x xO : * . SYS/ POS I T I ON : - 1( 

Files copied: 
DK:DT.SYS to xxO:DT.SYS 
DK:DP.SYS to xxO:DP.SYS 
DK:DX,SYS to xxO:DX.SYS 



•COPY/SYSTEM RK.SYS x xO : * . SYS/ POS I T I ON : - 1( 

Files copied: 
DK:RK,SYS to xxO:RK,SYS 
DK:RF,SYS to xxO:RF.SYS 



.COPY/SYSTEM MM .SYS x xO : # , SYS/ POS I T I ON : - 1( 
Files copied: 
DK:MM.SYS to xxO:MM.SYS 
DK:MT.SYS to xxO:MT,SYS 
DK:MS.SYS to xxO:MS.SYS 



• COPY/SYSTEM LK .SYS x xO : * . SYS/ POS I T I ON : - 1( 

Files copied: 
DK:LS.SYS to xxO:LS.SYS 
DK:LP.SYS to xxO:LP.SYS 



COPY PIP.SAV xxO:PIP.SAi.'/POSITION 
COPY DUP.SAV xxO:DUP, SAM/POSITION 
COPY DIR.SAV xxO:DIR. SAY/POSITION 



-1© 

-l© 
-1© 



Copy the rest of the files. The following command queries you about all the 
files on the disk so that you can choose the files it copies. 

.COPY/SYSTEM/QUERY DK : x xO : / POS I T I ON : - l© 

Files copied: 
DK : aaaaaa. ttt to xxO : aaaaaa . 1 1 1 ? YffiD (to include a specific file) 

DK:zz3zzz,ttt to xxO:zzzzzz.ttt? N@E) (to exclude a specific file) 

(and so on) 

Rewind the newly created backup working system magtape, remove it, la- 
bel it "Backup Working System RT-11 V05", and then store it. 

8.10 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
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major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, you need a terminal with a bell, and your 
working system must include at least the following components. 

SWAP.SYS 

RT11FB.SYS 

xx. SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 

, DIRECTORY/BRIEF/COLUMNS: 1 SY:(EB 

d d - w ii) w - '/ v 
SWAP ,SYS 
RT11FB.SYS 
LP .SYS 
DL .SYS 
MT .SYS 
EDIT . SAV 
MACRO .SAY 
SYSMAC.SML 
LINK . SAV 
PIP .SAM 



xxx Files i bbb Slocks 
fff Free blocks 



NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type ( ctrl7s~) to stop the display and 
(ctrl/qI to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
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DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 



8.10.1 Preparing the Background Demonstration Program 



8.10.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

* EDIT SY:DEMOBG. MACES) 

* F5GD. ASCI I mm 

* OADdENliS) 

* EXdEKED 



8.10.1.2 Assemble the Background Demonstration Program — The back- 
ground program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble DEM- 
OBG.MAC and obtain a listing, make sure that your configuration has a 
line printer that is on-line and ready. 

- ASSIGN LP: LST:© 



NOTE 

If your configuration does not include a line printer, use the 
console terminal. 



ASSIGN TT: LST:(ES) 



Assemble DEMOBG.MAC as follows: 

• MACR0/LIST:LST: DEM0BG(® 

(See Figure 8-2.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

•RENAME SY:DEM0BG.BAK SY : DEMOBG . MAC®) 



8-12 Installing a System Distributed on Magtape to Run on Hard Disk 



Figure 8-2: DEMOBG Assembly Listing 
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8.10.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG.OBJ to produce an executable background program DEM- 
OBG.SAV. 



.LINK DEM05G(R|f) 



8.10.1.4 Run the Background Demonstration Program 
DEMOBG to check the results of the first exercise. 



Run the program 



,RUN DEMOBGIH) 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED • THIS IS THE LAST LINE, 

WELL DONE. 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

icfRTc; 
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If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

RENAME SYsDEMOBG.BAK SY : DEMOBG . MAC® 



Then, repeat the editing procedure. 

8.10.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and execute it in conjunction 
with DEMOBG.SAV. DEMOFG.MAC is a small foreground program that 
sends a message every 2 seconds to DEMOBG (running in the background), 
telling it to ring the terminal bell. DEMOBG recognizes these messages 
and rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

8.10.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

.MACRO/LISTsLST: DEMOFGdU 



The output resulting from this MACRO command is an object file called 
DEMOFG. OBJ. This file resides on your system volume. 

8.10.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

.LINK/FOREGROUND DEMOFG® 



8.10.2.3 Run the Foreground and Background Demonstration Programs — 

Type the following command to load and start DEMOFG.REL as the fore- 
ground job. 
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, FRUN DEMOFGdB 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM. DEMOBG 

EVERY 2 SECONDS. TELLING IT TO RING THE BELL, 

(CTRL/ B ] 

B> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG. SAV in the background and re- 
ceive the messages. 

, RUN DEHOBGdB 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE, 

WELL DONE, 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 

(CTRL/C ) 
(CTRL/C) 

(The bell stops ringing.) 

, DIRECTORY© 
d d - m m m - y y 

(The directory of the device DK prints on the terminal.) 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

, RUN DEMOBG®) 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE.. 

NELL DONE. 

fcTRL/C) 



(CTRL/ C ) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 



(CTRL/F I 

F> 
iCTRL/C ) 



CTRL/C) 
B> 

UNLOAD F® 
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If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

8.11 Performing the System Generation Process 

If you have decided that you need RT-11 features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-11 System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 9 

Installing RT-11 on a MICRO/PDP-11 Processor 



If you are installing RT-11 to run on a MICRO/PDP-11 processor, perform 
the procedures described in this chapter. You will have received the RT-11 
operating system on RX50 diskettes, and will be installing it to run on a 
nonremovable RD51 disk. 

Your distribution kit contains two exact copies of the RT-11 operating 
system on RX50 diskettes. Store one copy in a safe place, and do not modify 
the contents; this provides a backup (master) copy of the distributed RT-11 
operating system. 

Store the second copy in a safe place after copying the contents onto the 
RD51 disk. Use these diskettes if it is ever necessary to copy their contents 
onto the permanent disk, for example, to create another working system. If 
these diskettes are ever damaged, use the master copy to reproduce them. 

NOTE 

If your hardware configuration includes a VT100 terminal, 
be sure to set AUTO XON/XOFF in SETUP mode B before 
attempting to bootstrap RT-11. Never set TT NOPAGE when 
you use this terminal. Refer to your hardware manuals for 
more information about these settings. 

To install your system, perform the steps summarized in the following list. 
Sections 9.1 through 9.11 describe the procedures involved in each step. 
Figure 9-1 shows the backup working system diskettes you create when 
you install RT-11 on a MICRO/PDP-11 processor. 

1. Bootstrap the system diskette. 

2. Install software updates. 

3. Copy the system diskette onto the system disk. 

4. Install the bootstrap on the system disk. 
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5. Copy the distribution diskettes onto the system disk. 

6. Create the working system from chosen components. 

7. Customize the system. 

8. Compress the system disk. 

9. Preserve the working system. 

10. Test the working system. 

11. If appropriate, perform the system generation process. 

The following sections correspond to each of these steps and describe in 
detail the procedures you must perform to complete each step. 

Figure 9-1: Sample Backup Diskettes 



RX50 

DISTRIBUTION 

DISKETTES 




WORKING 
SYSTEM 
DISK 
(FIXED) 



STORAGE CABINET 



9.1 Bootstrapping the System Diskette 

The first procedure you perform when installing ilT-11 is to bootstrap the 
system diskette. 

Begin by making sure that the processor is powered up but not running. 
Insert the system diskette, labeled 1, in RX50 diskette Unit 1 (which has 
the physical device name DU1:). Use the hardware bootstrap to boot the 
diskette. RT-11 should respond with the following message if you have 
successfully bootstrapped the system diskette. 
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RT-11FB M05,xx 
.TYPE M5USER.TXT 

RT-11 U5,kk 



installation of RT-ii ....(followed by V5USER.TXT message) 



After you boot the system, you can create a start-up file containing any 
sequence of commands that you would normally want to execute at the 
start of each terminal session. 

You can update your start-up file at any time to change, add, or delete 
commands. When you first create the file, or after you update it, you can 
execute it with the (a command, so that the commands it contains become 
) effective. 

9=2 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Update modules are critical to system or compo- 
nent operation. They correct software errors discovered since the last re- 
lease, and may add new functions to the operating system. 

I Updated software modules are distributed in update kits. Each kit contains 

complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the update kit to your system, using 
the procedures described in the RT-11 Update User's Guide. Updates are 
distributed on the same medium on which you received the base system and 
contain modules for both base system and layered products. 

When you submit an SPR, the RT-11 Software Dispatch Review will report 
) serious problems and may contain suggested solutions to the problems until 

the module containing the error is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

9.3 Copying the System Diskette onto the System Disk 

Once you have installed software updates, copy the system diskette onto 
the system disk (RD51). 

You must first use the INITIALIZE command to initialize the RD51 system 
disk in Unit 0. Use the /BADBLOCKS option with INITIALIZE to cover 
any bad blocks that may be on your disk. If the disk contains bad blocks, 
the ?DUP-W-Bad blocks detected nnnnnn message appears on the termi- 
nal. 
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( INITIALIZE/BADBLOCKS DUO:© 

D U : / I n i t i a 1 i z e ! Are you sure? Y ®> 
?DUP-I-No bad blocks detected DUO: 



The system scans the disk for bad blocks and creates a new directory. The 
monitor dot appears when this process is complete. 



Then, copy the contents of the system diskette to the disk. 

COPY/SYSTEM/NOQUERY DU1: DUO:®) 



9.4 Installing the Bootstrap on the System Disk 

Once you have copied the contents of the system diskette onto the system' 
disk, you need to install the bootstrap on the system disk. 

COPY/BOOT DU0:RT11FB.SYS DUO:®) 



In this command, you identify the device on which the monitor that con- 
tains the bootstrap information resides (DUO:), the name of the monitor file 
(RT11FB), and the device on which you need to install the bootstrap (DUO:). 
This command copies bootstrap information from the monitor file to blocks 
and 2 through 5 of the same volume. Remove the system diskette from 
Unit 1, and use the hardware bootstrap to boot the system disk. 

RT-11 should respond with the following message if you have successfully 
bootstrapped the system disk: 

RT-11FB M05,xx 

(Followed by any start-up file commands.) 



9.5 Copying the Distribution Diskettes onto the System Disk 

The next operation you perform with the running RT-11 system is to copy 
the remaining distribution diskettes onto the system disk, which will serve 
as your working system disk. 

Insert distribution diskette 2 in Unit 1, and copy all its files to the system 
disk by typing the command: 

COPY/SYSTEM/NOQUERY DU1: DUO:® 



Remove the distribution diskette from Unit 1 and store it; mount distribu- 
tion diskette 3 in Unit 1, and copy all its files to the system disk by typing 
the command: 

COPY/SYSTEM/NOQUERY DU1: DUO:© 
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Repeat this procedure to copy the remaining distribution diskettes onto the 
system disk. When you have completed copying all distribution diskettes, 
store them in a safe place. 

Next, remove the protection from all the files on the system disk. The files 
on the distribution diskettes have been protected to prevent you from acci- 
dentally deleting them. (Refer to the RT-11 System User's Guide for a 
description of file protection.) When you copied the files to the system 
disk, RT-11 also copied the protection. (Note the P that prints next to the 
file size in the directory.) For the rest of these procedures, you must remove 
the protection from the files on the system disk. 

Type the following command to remove the protection from all files: 

• UNPROTECT/SYSTEM DUO:*.*© 

Files unprotected: 
DUO: aaaaaa. ttt 
DUO: bbbbbb .ttt 
DUO:ccccco.ttt 
DUO: dddddd .ttt 



DUO: zzzzzz.ttt 



9.6 Creating the Working System from Chosen Components 

Once you have chosen your system components (Section 2.3), you can create 
the working system by deleting selected components from your system disk. 

You can use the following command to avoid typing numerous file specifica- 
tions. RT-11 queries you about all the files on the disk, and you choose the 
files it deletes. 



.DELETE/SYSTEM/QUERY DUO: 

Files deleted: 
DUO : aaaaaa , ttt Yffl) 
DUO: bbbbbb. ttt N(H) 

(and so on) 



(to delete a specific file) 
(to retain a specific file) 



Repeat this procedure to retain only the files you planned for the working 
system disk. 



9.7 Customizing the System 



You may want to make certain customizations (described in Section 2.7) to 
the distributed RT-11 components. At this point, perform the procedures to 
implement any of these software customizations. Table 1-3 summarize^ the 
available customizations and directs you to the section in Chapter 2 that 
describes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation process to im- 
plement additional customizations. (See Section 9.11.) 
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9.8 Compressing the System Disk 

DIGITAL recommends that you compress the working system disk to make 
its free space contiguous. Consolidating free space allows you to use space 
on the disk that would otherwise be too fragmented to be usable. 

Use the SQUEEZE command to compress free space. (The volume must be 
write-enabled.) 

.SQUEEZE DUO-.m 

DUO : /Squeeze i Are you sure? YES) 

RT-1 lxx U05. xx 

The system automatically reboots when you compress a system disk. 

9.9 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files and preserve the system on backup diskettes. 

Use the following command to protect all the files on the system disk: 

•PROTECT/SYSTEM DUO:#.*d3 
Files protected: 
DUO:aaaaaa.ttt 
DUO: bbbbbb. ttt 
DUO:cccccc.ttt 



DUO :zzzzzz.ttt 



Insert a blank RX50 diskette in Unit 1 or 2 so you can initialize it. You can 
use the INITIALIZE command with the /BADBLOCKS option to initialize 
the diskette and to detect any bad blocks that may be on it. If the diskette 
contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message 
appears on the terminal. In the command, x is the device unit number. 

NOTE 

RX50 diskettes are not formattable. DIGITAL recommends 
that you use only diskettes that have no bad blocks. To ascer- 
tain whether an already initialized diskette has bad blocks, 
use the command DIRECTORY/BAD DUn:, where n is the 
drive number. If bad blocks exist on a diskette, copy the con- 
tents of the diskette to an error-free diskette, and dispose of 
the diskette with bad blocks. 



.INITIALIZE/BADBLOCKS DUx:(® 

D U x : / I n i t i a 1 i z e ! Are you sure? Yd 

?DUP-I-No bad blocks detected DUx 
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There will be a delay while the system scans the diskette for bad blocks and 
creates a new directory. The monitor dot appears when this process is com- 
plete. 



Now, remove the newly initialized diskette and initialize an adequate num- 
ber of blank diskettes, leaving one initialized, blank, write-enabled (write- 
protect notch uncovered) diskette inserted in Unit 1 or 2. 

Copy all the files in your working system, using the COPY/MULTI- 
VOLUME command. In the command, x is the device unit number. The 
system copies all the files from the input volume that will fit on the output 
volume. When no more files will fit on the output volume, the system 
prompts you to mount the next output volume and prints the Continue'? 
message. 

Mount another blank, initialized diskette, and type Y to continue. Continue 
to mount diskettes in this fashion until all the files are copied. 

. COPY/MULTIMOLUME/SYSTEM DUO: DUx;(© 

Files copied: 
y •/ : a a a a a a . t 1 1 to D X 1 : a a a a a a . 1 1 1 
y y : b b b b b b . 1 1 1 to DX 1 : b b b b b b , 1 1 1 

(and so on) 



M o u n t next o u t p u t u o 1 u in e 


i n 


D) 


(1 : ; 


C o n t i n 


Lie? Y 


(Log of files copied) 












M o u n t next outp u t u o 1 u m e 


i n 


D) 


(1 : ; 


C o n t i n 


ue? Y 


(Log of files copied) 












M o u n t next outp u t u o 1 u m e 


i n 


d: 


(1 : ; 


C o n t i n 


ue? Y 


(Log of files copied) 












M o u n t next outp u t vol u w e 


i n 


d; 


;i : ; 


C o n t i n 


ue"? Y 


(Log of files copied) 












M o u n t next outp u t uol u m e 


i n 


D) 


;i .- ; 


Conti n 


ue? Y 


(and so on) 













Then, install the bootstrap on any backup working system diskettes that 
need to be bootable. In the following command, aa is BL, SJ, FB, or XM. 



.COPY/BOOT DUx:RTllaa DUx:( 



Remove the newly created working system diskette from Unit 1 or 2, and 
label it "Backup RT-11 V05 x" (where x is the diskette number). (Use a 
soft-tipped pen when you label diskettes.) Then, store it in a safe place. If 
you ever need to restore the working system, you can make copies of the 
backup working system diskettes. 

As long as the diskette you intend to copy is bootable and contains certain 
system utility programs, you can boot RT-11 from that diskette and copy 
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the diskette. Distribution diskette is bootable, but the rest of the diskettes 
in your kit are not bootable, because they lack the necessary components. 
Remember that a bootable diskette needs an appropriate monitor file, a 
bootstrap, a system device handler, the SWAP.SYS file, and for the SJ 
monitor, the TT.SYS file. 

9.10 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 

RT11FB.SYS 

DU.SYS (system device handler) 

LP.SYS 

EDIT.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

NOTE 

If your configuration includes a VT11 or VS60 display proces- 
sor and scope, shift system output to the display scope. Type 
GT ON. Verify that the scope is on by turning the BRIGHT- 
NESS knob to an adequate level. You can still enter com- 
mands at the keyboard, but the echo is on the screen. 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 

_ DIRECTORY/BRIEF/COLUMNS: 1 SY:(® 
d d - M m iii - y y 



SWAP 


.SYS 


RT11FB 


, SYS 


LP 


, SYS 


DU 


.SYS 


EDIT 


. SAV 


MACRO 


. SAV 
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SYSMAC. SMI- 
L-INK . SAV 
PIP , SAV 



xxx Filesi bbb Blocks 
fff Free blocks 



NOTE 

If you have shifted output to a scope and the directory scrolls 
by too quickly to read, type (ctrl/s) to stop the display and 
(ctrl/q) to restart it. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and you must assemble and link the foreground program, 
DEMOFG.MAC. 

9.10.1 Preparing the Background Demonstration Program 

9.10.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example, EDIT.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the output lines in the program is preceded by a 
semicolon, which makes the line a comment field. The semicolon prevents 
the line from being printed; thus, it must be deleted from that line. If 
DEMOBG.MAC is a protected file, remove the protection before making the 
edits (UNPROTECT SY:DEMOBG.MAC). 

. EDIT SY: DEMOBG.MAC®) 
*F i®, ASCI iEUdE) 

* A D® IE) 

* EXQ 



9.10.1.2 Assemble the Background Demonstration Program — The back- 
ground program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. To assemble 
DEMOBG.MAC and obtain a listing, make sure that your configuration 
has a line printer that is on-line and ready. 



ASSIGN LP: LST:( 



NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

.ASSIGN TT: LST:®) 
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Assemble DEMOBG.MAC as follows: 

,MACRO/LIST:LST: DEMOBGdD 

(See Figure 9-2.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits. Use the backup demon- 
stration program. 

.RENAME SY: DEMOBG. BAK SY : DEMDBG , MAC®! 

t 

Figure 9-2: DEMOBG Assembly Listing 

DEMDBG MACRO Y05.01b Friday 09-D»c-83 10:16 Pag« 1 



000000 
0000.3-1 
00004? 00077"/ 



000014 

0000^2 

000J06 000207 



20 000] to 



000112 
000t47 



ooo:;?a 

000P42 



124 
10A 



.TITLE DEMOBG 

. IDENT /Y05.00/ 
DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE. THEN 
RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDC. .PRINT 

TART!: .RCVDC #AREA.*SUFFER.*400.*MSGIN .POST request for message 
.PRINT *MSG fPRINT DEMONSTRATION MESSAGE 

BR SAND L OOF- 

COMPLETION ROUTINE ENTERED UHEN FG SENDS MESSAGE 

SGIN: .PRINT *BELL {RING BELL IN RESPONSE TO MESSAGE 

.RCUDC *AREA»*BUFFER.*400»*MSGIN (POST ANOTHER MESSAGE REQUEST 

RETURN {AND RETURN FROM COMPLETION ROUTINE 



bell: 
msg: 



ASCII MESSAGES 
.NLIST BEX 
.BYTE 7.200 



{MESSAGE THAT RINGS BELL 



.ASCII /RT-11 DEMONSTRATION PR0GRAM/<15> "12> 

• ASCII /IF INCORRECTLY EDITED. THIS IS THE LAST LINE . /* 15.- 

.ASCII /UELL DONE./ 

.BYTE 



AREA : 
BUFFER! 



.BLMJ 6 

.END START 



rEMT argument area 

i RCVDC MESSAGE area 



DEMOBG MACRO V05.01b Fr 
Symbol (.ablp 



day 09-Dec-83 10:16 Page 1-1 



ARFA 000:'1?6R 

BELI 0001 10R 

. AHS. 000000 
00024 2 
I ■' rrcit'i det.ee ted! 



BUFFER 
MSG 



000242R 
OO0112R 



MSG IN 

START 



000044R 
OOOOOORG 



000 

001 



(RU. I .GBL.ABS.OVR) 
CRW.I .LCL.REL.CON) 



*** Assembler statistics 



Work flip reads 
Uort Tile un t.B'; 
Sire of wcirl* fill' 
Size of core pool 
Operating system 



9188 Words 
1A128 Idoi-Ms 
RT-11 



3A Paaes 1 
( 63 Fades) 



Elar-sed time! 00100:05.45 

I)N ! DEMOBG . DK i DEMOBG=n* I I>E MOBG 



.vi ■-- 000003 



. . .V2 ■- 000027 



9.10.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG. OBJ to produce an executable background program, DEM- 
OBG.SAV. 

.LINK DEMOSG® 



9.10.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 
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•RUN DEMOBGES) 

RT-tl DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITEDt THIS IS THE LAST LINE. 

WELL DONE, 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 

(CTRL/C) 
[CTRL/C ) 



If you incorrectly edited the file, you can repeat this exercise, although you 
can continue without correcting the file. However, if you want to repeat the 
exercise, begin by using the backup demonstration program. 

•RENAME SY:DEMOBG.BAK SY : DEMOBG . MACdH 



Then, repeat the editing procedure. 

9.10.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program DEM- 
OFG.MAC, link it for the foreground, and execute it in conjunction with 
DEMOBG.SAV. DEMOFG.MAC is a small foreground program that sends 
a message every 2 seconds to DEMOBG (running in the background), tell- 
ing it to ring the terminal bell. DEMOBG recognizes these messages and 
rings the bell once for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the "messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

9.10.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
file; it must be assembled and linked before you can use it. Assemble 
DEMOFG.MAC as follows: 

•MACRO/LIST:LST: DEMOFGdD 
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The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ. This file resides on your system volume. 

9.10.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type signifies to the system that the file is a foreground program and is to 
be run as a priority job. 

LINK/FOREGROUND DEMOFGED 



9.10.2.3 Run the Foreground and Background Demonstration Programs — 

Type the following command to load and start DEMOFG.REL as the fore- 
ground job. 

FRUN DEMOFGdD 
F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE 5ACKGR0UND PROGRAM DEMOBG 
EVER Y 2 SECONDS* TELLING IT TO RING THE BELL. 
[CTRL/B ] 
B> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG.SAV in the background and re- 
ceive the messages. 

,RUN DEMOBG© 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED , THIS IS THE LAST LINE, 

WELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 



ICTBUC] 
(CTRL/C) 

(The bell stops ringing.) 
.DIRECTOR Y(H) 
d d - ii) (ii in - v •/ 

(The directory of the device DK prints on the terminal.) 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

.RUN DEMOBG®) 
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(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED. THIS IS THE LAST LINE. 

NELL DONE. 

(CTRL/C) 



(CTRL/C) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 

(CTRL; F ) 

F> 
(CTRL/C) 

( cTrlTcT i 

B> 

UNLOAD F<m 

NOTE 

If your configuration includes a graphics display, turn it off 
at this point. Type GT OFF. 

If you completed these exercises without error, your system has passed this 
minimal test and you can consider it successfully installed. 

9.11 Performing the System Generation Process 

If you have decided that you need RT-ll features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation process at this point. You should have thoroughly studied Chapter 1 
to make this decision and to establish that you can perform the system 
generation process on your particular hardware configuration. Read the 
RT-ll System Generation Guide for guidance in planning and performing 
system generation. 
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Chapter 1 

Installing RT-11 on a Professional 325 Computer 



If you are installing RT-11 to run on a Professional 325 computer, perform 
the procedures described in this chapter. 

Your distribution kit contains two copies of the RT-11 operating system on 
RX50 diskettes. Store one set of the RX50 diskettes in a safe place and do 
not modify their contents; they provide a master copy of the distributed 
RT-11 operating system. 

Store the second set of diskettes in a safe place, after installing software 
updates and creating your working system diskettes. The second set pro- 
vides a backup copy of your updated RT-11 system. If those diskettes are 
ever damaged, use the master copy of the distributed RT-11 operating sys- 
tem to reproduce them. 

To install your system, perform the procedures summarized below and de- 
scribed in Sections 10.1 through 10.8. Figure 10-1 shows the diskettes you 
create when you install RT-11. 

1. Bootstrap the system diskette. 

2. Install software updates. 

3. Create the working system from chosen components. 

4. Install the bootstrap on any diskettes that must be bootable. 

5. Customize the system. 

6. Preserve the working system. 

7. Test the working system. 

8. If appropriate, perform the system generation procedures. 
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Figure 10-1: Sample Backup Diskettes 




RX50 BACKUP 

DISKETTES 

(MASTER) 



INSTALL UPDATES 




RX50 

DISTRIBUTION 

DISKETTES 



COPY 

SELECTED 

FILES 



J WORKING 
SYSTEM 
DISKETTES 



BACKUP 
WORKING 
SYSTEM 
DISKETTES 



STORAGE CABINET 

10.1 Bootstrapping the System Diskette 

The first procedure you perform when installing RT-11 bootstraps the sys- 
tem diskette, distribution diskette 1. 

First, turn off the processor (press the power switch to 0). 

Insert the distribution diskette labeled 1 in Unit (which has the physical 
device name DZO:). Unit is the top slot if your Professional 325 sits hori- 
zontally on a table top, or the left slot if it sits vertically in a floor stand. 

Press the power switch to 1 (on). Wait while the system runs diagnostic 
tests. If there are no problems, the DIGITAL logo appears on the screen 
within about 30 seconds. 

If a problem occurs, a diagram of the Professional computer appears on 
your screen. The part of the Professional that has a problem is highlighted 
in the picture. Write down the numbers you see on the screen. If the top 
number is 051124, refer to Chapter 7 of the RT-11 System Message Man- 
ual. Otherwise, refer to your Professional 300 Series Owner's Manual. 

If nothing happens when you turn the power on, refer to the Professional 
300 Series Owner's Manual for help. 

RT-11 should respond with the following message if you have successfully 
bootstrapped the diskette: 
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RT-11XM '.'05, xx 
.TYPE M5USER.TXT 

RT-11 i,'5.xx 



installation of RT-ii ....(followed by V5USER.TXT message).. 



10.2 Installing Software Updates 

You must install updated software modules at this point. Updated modules 
are critical to system or component operation. They correct software errors 
discovered since the last release, and may add new functions to the operat- 
ing system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules from the update kit to your system, using 
the procedures described in the RT-11 Update User's Guide. Updates are 
distributed on the same medium on which you received the RT-11 operat- 
ing system and contain modules for the operating system and layered prod- 
ucts. 

NOTE 

If you are installing your system for the first time, you need 
not update the RT-11 operating system. The RT-11 distribu- 
tion kit you received contains the most recent modules. 

The RT-11 Software Dispatch Review reports serious problems submitted 
in SPRs and may provide temporary solutions to use until the module con- 
taining the errors, is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

10.3 Creating the Working System from Chosen Components 

Once you have chosen your system components and have planned the best 
arrangement of them on diskettes (See Sections 2.3 and 2.4), you can create 
the working system by copying selected components to initialized blank 
diskettes. 

Start by initializing a number of blank diskettes. Insert each diskette in 
Unit 1 and use the INITIALIZE command. Use the /BADBLOCKS option 
with INITIALIZE to cover any bad blocks that may be on your diskettes 
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(this prevents the system from trying to use them). If a diskette contains 
bad blocks, the ?DUP-W-Bad blocks detected nnnnnn message appears on 
the terminal. 

NOTE 

DIGITAL recommends that you use only diskettes that do 
not have bad blocks when you build a working system. To 
ascertain whether an initialized diskette has bad blocks, use 
the command DIRECTORY/BAD DZn:. You can use dis- 
kettes with bad blocks later for temporary storage or as work 
volumes. 

JNITIALIZE/BADBLOCKS DZliffil 

DZ 1 : / I n i t i a 1 i 2 e i Are you s u r e ? Y ® 
?DUP-I-No bad blocks detected DZ1: 

The system scans the diskette for bad blocks and creates a new directory. 
The monitor dot appears when this process is complete. 



Repeat this step to create as many initialized blank diskettes as you need 
for the system you have planned, leaving one initialized, blank diskette in 
Unit 1. 

Then, use the COPY command to copy selected files from distribution dis- 
kette 1 to the diskette that will become your working system diskette. The 
/SYSTEM option is required for copying .SYS files only if wildcards are 
used in input file specifications. 

. COPY DZO : f i 1 n am . t •/ p DZ 1 : f i 1 n am . t y p© 



You can use the following command to avoid typing numerous file specifica- 
tions. RT-11 queries you about all the files on the diskette, and you choose 
the files it copies. 



, COPY/SYSTEM/QUERY DZO: DZl:© 

Files copied: 
DZO : aaaaaa . tt t to DZ 1 : aaaaaa . 1 1 1 ? Y © 
DZO :bbbbbb.ttt to DZ 1 : b b b b b b . 1 1 1? Nffl) 

(and so on) 



(to include a specific file) 
(to exclude a specific file) 



To copy files from nonbootable diskettes, you have to alternate diskettes. 

Type the following command, where filnam.typ is the name of the file you 
want to copy. 

.COPY / QUERY/ WA IT DZ 1 : f i 1 n am . t -/ p DZO : f i 1 n am . t y p® 
M o u n t i n p u t volume in D Z 1 : i Co n t i n u e ? 
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Place the diskette containing the file you want to copy in Unit 1. 



'in 



Files copied: 
DZ1 :aaaaaa. ttt to DZO:aaaaaa.ttt' 



Type Y to include or N to exclude the file. 

M o u n t o u t p u t u cd 1 u m e in D Z : i C o n t i n u e ? 



Replace the system diskette in Unit with the diskette to which you want 
to copy filnam.typ. 



Y@lD 

M o u n t s v s t e m u o 1 u m e in D Z : i C o n t i n u e ? 



Replace the diskette in Unit with the system diskette. 

Y© 



Repeat this procedure to copy all the files you planned for the working 
system diskette. 

When you have copied all the files, label the diskette "RT-11 Working 
System V05.n 1" (where n is the release number of RT-11 V5). 

Repeat those procedures to create the other diskettes in the working sys- 
tem. 



10.4 Installing the Bootstrap on Diskettes that Must be Bootable 

Once you have created your working system, you need to install the boot- 
strap on any diskettes that must be bootable (that you can use as system 
diskettes). Generally, any diskette that includes a monitor file and system 
device handler should be bootable. The diskette also needs SWAP. SYS, and 
PI(X).SYS to run on a Professional 325. 

Insert in Unit 1 the diskette on which you need to install the bootstrap. In 
the following command, aa is FB or XM. 

.COPY/BOOT DZ1 :RTllaa.SYS DZ1:(© 



This command copies bootstrap information from the monitor file to blocks 
and 2 through 5 of the same diskette. In the command, you identify the 
device on which the monitor that contains the bootstrap information re- 
sides, the name of the monitor file (RT11FB.SYS or RT11XM.SYS), and the 
device on which you need to install the bootstrap. 
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Then, insert working system diskette 1 in Unit 0, and use the hardware 
bootstrap (turn the system off, then on) to boot your working system. 

RT-l laa M05. xx 

(Followed by any start-up file commands.) 



Store the updated distribution diskettes for future updates. 



10.5 'Customizing the System 



You may want to make customizations (described in Section 2.7) to the 
distributed RT-11 components. At this point, perform the procedures to 
implement any software customizations. Table 1-3 summarizes the avail- 
able customizations and directs you to the section in Chapter 2 that de- 
scribes a particular customization and the procedure for implementing it. 

The files on the distribution diskettes have been protected to prevent you 
from accidentally deleting them. (Note the P that prints next to the file size 
in the directory. Refer to the RT-11 System User's Guide for a description 
of file protection.) You need to remove the protection from the files you 
want to customize. Type the following command to remove protection from 
the files on distribution diskette 1 (your system diskette): 

, UNPRDTECT/SYSTEM * . #© 

Files unprotected: 
DK:aaaaaa.ttt 
DK: bbbbbb. ttt 
DK:cccccc.ttt 
DK:dddddd, ttt 



DK : zzzzzz . ttt 



To remove protection from files on other diskettes, insert each diskette in 
Unit 1. Then type the following command: 

. UNPROTECT/SYSTEM DZl:*.*ffl) 

Files unprotected: 
DZl:aaaaaaittt 
DZ1 : bbbbbb , ttt 
DZl:cccccc.ttt 
DZ1 : dddddd . ttt 



DZl:zzzzzz.ttt 



NOTE 



Later, you can perform the system generation procedures to 
implement additional customizations. 
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10.6 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you preserve the system on backup diskettes. 

If you have unprotected files to make software customizations (Section 
10.5), use the following command to protect all the files on the system 
diskette: 

•PROTECT/SYSTEM * . #© 

Files protected: 
DK:aaaaaa.ttt 
DK: bbbbbb, ttt 
D K : icccccc.ttt 
DK:dddddd .ttt 



DK : zzzzzz . 1 1 1 



To protect files on other diskettes in the working system, insert each dis- 
kette in Unit 1 and use the following command: 

• PROTECT/SYSTEM. DZl :#.#(© 

Files protected: 
DZl : aaaaaa . 1 1 1 
DZl : bbbbbb, ttt 
DZl :cccccc.ttt 
DZl idddddd. ttt 



DZl : zzzzzz , ttt 



Next, copy the working system to backup diskettes. Insert blank diskettes 
in Unit 1 with RT-11 still booted from Unit 0, and initialize the appropri- 
ate number of diskettes. 

Then, copy all the files in your working system. To copy the system disk- 
ette, type: 

.SQUEEZE/0UTPUT:DZ1 : DZ0:ffl) 

To copy other diskettes, type this command and follow the instructions to 
change diskettes: 

-SQUEEZE/ WAIT/OUTPUT: DZl : DZO:(® 

Remember to copy the bootstrap to any diskettes that need to be bootable. 

Store the backup diskettes. If you ever need to restore the working system, 
you can make copies of the backup working system diskettes. 
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10.7 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 

RT11FB.SYS or RT11XM.SYS 

DZ.SYS or DZX.SYS (system device handler) 

PI.SYS or PIX.SYS 

LS.SYS or LSX.SYS 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Insert a blank diskette in Unit 1. 

. INITIALIZE/BADBLOCKS DZ1:(H) 
DZl:/Initializei Are you sure? y© 
?DUP-I-No bad blocks detected DZ1: 

. ASSIGN DZ1 ; DK:{aE> 

Display the system volume's directory on the terminal. The directory varies 
according to your particular working system. As long as a directory prints, 
you need not worry if it does not match the one inn the following example. 

- DIRECTORY/BRIEF/COLUMNS: 1 SY:(® 
d d - m m m - y y 



SWAP 


.SYS 


RTllxx 


.SYS 


PI 


, SYS 


LS 


.SYS 


DZ 


.SYS 


KED 


.SAM 


MACRO 


. SAM 


SYSMAC 


.SML 


LINK 


.SAM 


PIP 


. SAM 



xxx F i 1 e s i b b b Blocks 
fff Free blocks 
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NOTE 

If the directory scrolls by too quickly, press the HOLD 
SCREEN key to stop the display. Press HOLD SCREEN 
again to continue scrolling. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and then you must assemble and link the foreground pro- 
gram, DEMOFG.MAC. 

10.7.1 Preparing the Background Demonstration Program 

To prepare the background demonstration program, DEMOBG.MAC, fol- 
low these instructions to edit, assemble, link, and run the program. 

10.7.1.1 Edit the Background Demonstration Program — Use a text editor, for 
example KED, to modify the background demonstration program, DE- 
MOBG.MAC. One of the lines in the program contains a message to be 
printed, but it is preceded by a semicolon (the symbol for a comment field). 
You must delete the semicolon so the message will print. 

If DEMOBG.MAC is a protected file, remove the protection before making 
the edits (UNPROTECT SY:DEMOBG.MAC). 

To start KED, type: 

'KED DEMOBG.MACdH 

Once the file is displayed, press the down-arrow key until the cursor rests 
on top of the semicolon (;) at the beginning of the line: 

! .ASCII /WELL DONE./ 

Delete the semicolon by pressing the comma key (,) on the keypad. 

Then, exit the file: Press the PF1 key, then the 7 key on the keypad. When 
KED prompts Command:, type EXIT and press the ENTER key: 

Command: EXITfENTEFi) 

10.7.1.2 Assemble the Background Demonstration Program — The back- 
ground program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. 

To assemble DEMOBG.MAC and obtain a listing, make sure your configu- 
ration has a line printer that is on-line and ready. 

'ASSIGN LS: LSTs® 
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NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

.ASSIGN TT: LST:(H) 



Assemble DEMOBG.MAC as follows: 

.MACRO/LIST:LST: SY : DEMOBGGH) 

(See Figure 10-2.) 

If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits as described in Section 
10.7.1.1. Use the backup demonstration program. 

.RENAME SY:DEMDBG,BAK SY : DEMOBG , MAC© 



Figure 10-2: DEMOBG Assembly Listing 
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10.7.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 
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LINK DEMOBGt© 



10.7.1.4 Run the Background Demonstration Program — Run the program 
DEMOBG to check the results of the first exercise. 

•RUN DEMOBGdU 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED , THIS IS THE LAST LINE. 

WELL DONE, 

If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 



1CTRL/C) (CTRL/C) 

If you incorrectly edited the file, you can repeat the exercise, although you 
can continue without correcting the file. If you want to repeat the exercise, 
begin by using the backup demonstration program. 

• RENAME SY:DEMOBG,BAK SY : DEMOBG , MAC© 

Then, repeat the editing procedure (see Section 10.7.1.1). 



10.7.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and then execute it in conjunc- 
tion with DEMOBG.SAV. 

DEMOFG.MAC is a small foreground program that sends a message every 
2 seconds to DEMOBG (running in the background), telling it to ring the 
terminal bell. DEMOBG recognizes those messages and rings the bell once 
for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
the system immediately releases all the messages queued since the last 
forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

10.7.2.1 Assemble the Foreground Demonstration Program — The foreground 
demonstration program, DEMOFG.MAC, is an assembly language source 
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file which you must assemble and link before running. Assemble DE- 
MOFG.MAC as follows: 



, MACRO/LIST:LST: SY:DEM0FG(! 



The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ, which resides on your data volume (DK). 

10.7.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type tells the system that the file is a foreground program and should be 
run as a priority job. 

.LINK/FOREGROUND DEMOFGE) 



10.7.3 Run the Foreground and Background Demonstration 
Programs 

Type the following command to load and start DEMOFG.REL as the fore- 
ground job. 

.FRUN DEMOFG© 

F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE. TO THE BACKGROUND PROGRAM DEMOBG 

EVERY 2 SECONDS. TELLING IT TO RING THE BELL. 

(cTrITeT) 



DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG.SAV in the background and re- 
ceive the messages. 

,RUN DEMOBG® 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED/ THIS IS THE LAST LINE. 

NELL DONE. 

Execute a DIRECTORY command in the background to obtain a directory 

listing. 



(CTRL C ) (CTRL. C ) 

(The bell stops ringing.) 
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• DIRECTORY© 
d d - w m in - y y 

(The directory of the device DK prints on the terminal.) 

Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

•RUN DEMOBGdB 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-ll DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE. 

( STRUCT) (CTRUC) 

(The bell stops ringing.) 

Now, stop the foreground program and remove it from memory. 

[CTRL; F ) 
F> 



(CTRL) C ) (CTRL/C) 

B> 

UNLOAD F(H) 



If you completed these exercises without error, your system has passed the 
minimal test and you can consider it successfully installed. 

10.8 Performing the System Generation Procedures 

If you have decided that you need RT-ll features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation procedures at this point. You should have thoroughly studied Chapter 
1 to make this decision and to establish that you can perform the system 
generation procedures on your particular hardware configuration. 

DIGITAL does not recommend that you perform a system generation on a 
Professional 325. The process is lengthy and is not automated. However, 
should you decide to perform a system generation, read the RT-ll System 
Generation Guide for guidance. 
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Chapter 11 

Installing RT-11 on a Professional 350 Computer 



If you are installing RT-11 to run on a Professional 350 computer, perform 
the procedures described in this chapter. 

You will have received the RT-11 operating system on RX50 diskettes, and 
will be installing it to run on a nonremovable RD50 or RD51 disk. 



NOTE 

The procedures described in this chapter assume that your 
Professional 350 system includes an RD50 or RD51 Winches- 
ter disk. If your system does not include a Winchester disk, 
install RT-11 software by following the procedures described 
in Chapter 5. 

Your distribution kit contains two copies of the RT-11 operating system on 
RX50 diskettes. Store one set of the RX50 diskettes in a safe place, and do 
not modify their contents; they provide a master copy of the distributed 
RT-11 operating system. 

Store the second set of diskettes in a safe place, after installing software 
updates and copying their contents onto the nonremovable disk. The second 
set provides a backup copy of your updated RT-11 system. Use those dis- 
kettes if it is ever necessary to copy their contents onto the permanent disk, 
for example, to create another working system. If those diskettes are ever 
damaged, use the master copy of the distributed RT-11 operating system to 
reproduce them. 

To install your system, perform the procedures summarized below and de- 
scribed in Sections 11.1 through 11.11. Figure 11-1 shows the diskettes you 
create when you install RT-11. 

1. Bootstrap the system diskette. 

2. Install software updates. 



11-1 



3. Copy the system diskette onto the system disk. 

4. Install the bootstrap on the system disk. 

5. Copy the distribution diskettes onto the system disk. 

6. Create the working system from chosen components. 

7. Customize the system. 

8. Compress the system disk. 

9. Preserve the working system. 

10. Test the working system. 

11. If appropriate, perform the system generation procedures. 

Figure 11-1: Sample Backup Diskettes 
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11.1 Bootstrapping the System Diskette 

The first procedure you perform when installing RT-11 bootstraps the sys- 
tem diskette. 

First, turn off the processor (press the power switch to 0). 

Make sure the system diskette, labeled 1, is write-protected (with a write- 
protect tape over the notch), and insert it in diskette Unit (which has the 
physical device name DZO:). Unit is the top slot if your Professional 350 
sits horizontally on a table top, or the left slot if it sits vertically in a floor 
stand. 
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Press the power switch to 1 (on). Wait while the system runs diagnostic 
tests. If there are no problems, the DIGITAL logo appears on the screen 
within about 30 seconds. 

If a problem occurs, a diagram of the Professional computer appears on 
your screen. The part of the Professional that has a problem is highlighted 
in the picture. Write down the numbers you see on the screen. If the top 
number is 051124 refer to Chapter 7 of the RT-11 System Message Manual. 
Otherwise, refer to your Professional 300 Series Owner's Manual. 

If nothing happens when you turn the power on, refer to the Professional 
300 Series Owner's Manual for help. 

RT-11 should respond with the following message if you have successfully 
bootstrapped the system diskette. 

RT-11 MM V05.xx 
.TYPE M5USER.TXT 

RT-11 i.'5, xx 

installation of RT-ll ....(followed by V5USER.TXT message).... 



11.2 Installing Software Updates 

To make sure that RT-11 operates correctly, you must install updated soft- 
ware modules at this point. Update modules are critical to system or compo- 
nent operation. They correct software errors discovered since the last re- 
lease, and may add new functions to the operating system. 

Updated software modules are distributed in update kits. Each kit contains 
complete software module replacements. Software corrections will already 
have been installed in the new modules and fully tested. Your only require- 
ment is to copy the new modules ffrom the update kit to your system, using 
the procedures described in the RT-11 Update User's Guide. Updates are 
distributed on the same medium on which you received the RT-11 operat- 
ing system and contain modules for the operating system and layered prod- 
ucts. 



NOTE 

If you are installing your system for the first time, you need 
not update the RT-11 operating system. The RT-11 distribu- 
tion kit you received contains the most recent modules. 
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The RT-11 Software Dispatch Review reports serious problems submitted 
in SPRs and may provide temporary solutions to use until the module con- 
taining the errors is corrected by an update kit. 

For a complete description of how to update your software, refer to the 
RT-11 Update User's Guide. 

11.3 Copying the System Diskette onto the System Disk 

Once you have installed software updates, copy the system diskette onto 
the nonremovable system disk (RD50 or RD51). 

You must first use the INITIALIZE command to initialize the nonremov- 
able system disk. Use the /BADBLOCKS option with INITIALIZE to cover 
any bad blocks that may be on your disk (this prevents the system from 
trying to use them). If the disk contains bad blocks, the ?DUP-W-Bad 
blocks detected nnnnnn message appears on the terminal. 

.INITIALIZE/BADBLOCKS DWO: (BE) 

DWO : / I n i t i a 1 i z e i Are you sure 7 Y(BH) 

?DUP-I-No bad blocks detected DWO: 

The system scans the disk for bad blocks and creates a new directory. The 
monitor dot appears when this process is complete. 



Then, copy the contents of the system diskette onto the disk. 

.COPY/SYSTEM/NOPROTECT DZO: DWO:© 

t 

11.4 installing the Bootstrap on the System Disk 

Once you have copied the contents of the system diskette onto the system 
disk, you need to install the bootstrap on the system disk. 

.COPY/BOOT DWO:RTl 1XM.SYS DWO:© 



This command copies bootstrap information from the monitor file to blocks 
and 2 through 5 of the same volume. In the command, you identify the 
device (DWO:) on which resides the monitor that contains the bootstrap 
information, the name of the monitor file (RT11XM), and the device on 
which you need to install the bootstrap (DWO:). 

Remove the system diskette from Unit 0, and use the hardware bootstrap to 
boot the system disk. RT-11 should respond with the following message if 
you have successfully bootstrapped the system disk: 

RT-11 KM 005, xx 

(Followed by any start-up file commands.) 
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11.5 Copying the Distribution Diskettes onto the System Disk 

The next operation you perform with the running RT-11 system copies the 
remaining distribution diskettes onto the system disk that will serve as 
your working system disk. 

Insert distribution diskette 2 in Unit 0, and copy all its files to the system 
disk by typing the command: 

.COPY/SYSTEM/NOPROTECT DZO: DWO:© 



Remove the distribution diskette from Unit and store it. Then repeat this 
procedure to copy the remaining distribution diskettes onto the system 
disk. When you have completed copying all distribution diskettes, store 
them in a safe place. 

11.6 Creating the Working System from Chosen Components 

Once you have chosen your system components (see Section 2.3), you can 
create the working system by deleting selected components from your sys- 
tem disk. 

You can use the following command to avoid typing numerous file specifica- 
tions. RT-11 queries you about all the files on the disk, and you choose the 
files it deletes. 



, DELETE/SYSTEM/QUERY DWO 

Files deleted: 
DWO : aaaaaa . 1 1 1 Yffl) 
DWO: bbbbbb. ttt N(H) 

(and so on) 



(to delete a specific file) 
(to retain a specific file) 



Repeat this procedure to retain only the files you planned for the working 
system disk. 



11.7 Customizing the System 

You may want to make customizations (described in Section 2.7) to the 
distributed RT-11 components. At this point, perform the procedures to 
implement any software customizations. Table 1-3 summarizes the avail- 
able customizations and directs you to the section in Chapter 2 that de- 
scribes a particular customization and the procedure for implementing it. 

NOTE 

Later, you can perform the system generation procedures to 
implement additional customizations. 

11.8 Compressing the System Disk 

DIGITAL recommends that you compress the working system disk to make 
its free space contiguous. Consolidating free space lets you use space on the 
disk that would otherwise be too fragmented to be usable. 
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Use the SQUEEZE command to compress free space. (The volume must be 
write-enabled.) 

•SQUEEZE DW0:(H) 

DWO : /Squeeze i Are you sure? Y(H) 

RT-1 lxx ^05 . xx 

The system automatically reboots when you compress a system disk. 

11.9 Preserving the Working System 

Once you build a satisfactory working system, DIGITAL recommends that 
you protect all the files and preserve the system on backup diskettes. 

Use the following command to protect all the files on the system disk: 

.PROTECT/SYSTEM DWO :*.*(© 

Files protected: 
DWO:aaaaaa.ttt 
DWO:bbbbbb. ttt 
DWO:cccccc.ttt 



DW0:z2zzzz.ttt 



Insert a blank RX50 diskette in diskette Unit or 1 so you can initialize it. 

You can use the INITIALIZE command with the /BADBLOCKS option to ) 

initialize the diskette and to detect any bad blocks that may be on it. If the 

diskette contains bad blocks, the ?DUP-W-Bad blocks detected nnnnnn 

message appears on the terminal. In the command, n is the device unit 

number. 

NOTE 

DIGITAL recommends that you use only diskettes that have 
no bad blocks. To ascertain whether an already initialized ) 

diskette has bad blocks, use the command DIRECTORY/BAD 
DZn: where n is the drive number. If bad blocks exist on a 
diskette, copy the contents of the diskette to an error-free 
diskette. You can use diskettes with bad blocks later for tem- 
porary storage or as work volumes. 

.INITIALIZE/BADBLOCKS DZn:© 

D Z n : / I n i t i a 1 i z e i Are you sure? Y EH) 

?DUP-I~No bad blocks detected DZn: 

There will be a delay while the system scans the diskette for bad blocks and 
creates a new directory. The monitor dot appears when this process is com- 
plete. 
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Now, remove the newly initialized diskette and initialize an adequate num- 
ber of blank diskettes, leaving one initialized, blank, write-enabled (write- 
protect notch uncovered) diskette inserted in Unit or 1. 

Copy all the files in your working system, using the COPY/MULTI- 
VOLUME command below. In the command, n is the device unit number. 
The system copies all the files from the disk (the input volume) that will fit 
on the diskette (the output volume). When no more files will fit on the 
diskette, the system prompts you to mount another output volume and 
prints the Continue? message. 

Mount another blank, initialized diskette, and type Y to continue. Continue 
to mount diskettes in this fashion until all the files are copied. 

• COPY/MULT U'OLUME/SYSTEM DWO : DZn:© 

Files copied: 
DWO:aaaaaa.ttt to DZn:aaaaaa.ttt 
DWO : b b b b b b . 1 1 1 to DZn : b b b b b b , 1 1 1 

(and so on) 

M o u n t next o a t p u t u o 1 u in e in D Z n : ! C o n t i n a e ? y © 

(Log of files copied) 

M o u n t next out? u t vol u in e in D Z n : i C o n t i n u e ? Y © 

(Log of files copied) 
(and so on) 

Then, install the bootstrap on any backup working system diskettes that 
need to be bootable. In the following command, aa is FB or XM. 

• COPY/BOOT DZn:RTllaa DZn:© 



Remove each diskette from Unit or 1, and label it "Backup RT-11 V05 x" 
(where x is the diskette number). Use a soft-tipped pen when you label 
diskettes. Then, store them in a safe place. 

If you ever need to restore the working system, you can copy the backup 
working system diskettes to DW:. 

As long as the diskette you intend to copy is bootable and contains certain 
system utility programs, you can boot RT-11 from that diskette and copy 
the diskette. Distribution diskette 1 is bootable, but the rest of the diskettes 
in your kit are not bootable because they lack the necessary components. A 
bootable diskette needs an appropriate monitor file, a bootstrap, a system 
device handler, the SWAP.SYS file, and the Professional interface 
PI(X).SYS. 

11.10 Testing the Working System 

Once you have built and preserved the working system, you can execute the 
following demonstration to test that system. This demonstration does not 
serve as a comprehensive system exercise; however, because it uses several 
major system components, it does serve as a minimal integrity check. More- 
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over, DIGITAL considers your system officially installed if the demonstra- 
tion runs without error. 

To execute this demonstration, your working system must include at least 
the following components. 

SWAP.SYS 

RT11FB.SYS or RT11XM.SYS 

DW.SYS or DWX.SYS (system device handler) 

PI.SYS or PIX.SYS 

LS.SYS or LSX.SYS 

KED.SAV 

MACRO.SAV 

SYSMAC.SML 

LINK.SAV 

PIP.SAV 

DUP.SAV 

DIR.SAV 

DEMOBG.MAC 

DEMOFG.MAC 

Display the directory of the system volume on the terminal. The directory 
varies according to your particular working system. As long as a directory 
prints, you need not worry if it does not match the one in the following 
example. 

, DIRECTORY/BRIEF/COLUMNS: 1 SY:(H) 
d d - m m m - y y 



SWAP 


.SYS 


RT11FB 


, SYS 


LS 


.SYS 


DW 


.SYS 


PI 


.SYS 


KED 


.SAM 


MACRO 


, SAY 


SYSMAC 


.SML 


LINK 


. SAV 


PIP 


. SAV 



xxx Files i bbb BlocKs 
fff Free blocks 



NOTE 

If the directory scrolls by too quickly, press the HOLD 
SCREEN key to stop the display. Press HOLD SCREEN 
again to continue scrolling. 

Before you can execute the background and foreground demonstration pro- 
grams, you must first edit, assemble, and link the background program, 
DEMOBG.MAC, and then you must assemble and link the foreground pro- 
gram, DEMOFG.MAC. 
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11.10.1 Preparing the Background Demonstration Program 

To prepare the background demonstration program, DEMOBG.MAC, fol- 
low these instructions to edit, assemble, link, and run the program. 

11.10.1.1 Edit the Background Demonstration Program — Use a text editor, 
for example, KED.SAV, to modify the background demonstration program, 
DEMOBG.MAC. One of the lines in the program contains a message to be 
printed, but it is preceded by a semicolon (the symbol for a comment field). 
You must delete the semicolon so the message will print. 

If DEMOBG.MAC is a protected file, remove the protection before making 
the edits (UNPROTECT SY:DEMOBG.MAC). 

To start KED, type: 

. KED DEMOBG.MAC®) 

Once the file is displayed, press the down-arrow key until the cursor rests 
on top of the semicolon (;) at the beginning of the line: 

i .ASCII /WELL DONE,/ 

Delete the semicolon by pressing the comma key (,) on the keypad. 

Then, exit the file: press the PF1 key, then the 7 key on the keypad. When 
KED prompts Command:, type EXIT and press the ENTER key: 

Command: EXIT (ENTER ) 

11.10.1.2 Assemble the Background Demonstration Program — The back- 
ground program, DEMOBG.MAC, is an assembly language source file; it 
must be assembled and linked before you can execute it. 

To assemble DEMOBG.MAC and obtain a listing, make sure that your 
configuration has a line printer that is on-line and ready. 

, ASSIGN LS: LST:(® 



NOTE 

If your configuration does not include a line printer, use the 
console terminal. 

. ASSIGN TT: LST:ED 



Assemble DEMOBG.MAC as follows: 

, MACRO/LIST;LST: DEMOBG© 

(See Figure 11-2.) 
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If any errors occur when you assemble DEMOBG.MAC, you have incor- 
rectly edited the file and should repeat the edits as described in Section 
11.10.1.1. Use the backup demonstration program. 

.RENAME SY:DEMOBG.BAK SY : DEMOBG , MAC©) 



Figure 11-2: DEMOBG Assembly Listing 

DEMOBG MACRO yO!j.OO Saturday OB-Jar.-a.l 11M4 F'jae 1 



000000 
000011 

oooov. 1 mom 



1)00001 
0000')? 
000 I Oft 000J07 



:V) ooo] io 



0001 K? 
0001 1/ 



OOOITA 

ooo ;!•»:* 



1 1 1 

000 



r.*4 

106 



.TITLE DEMOBG 
.IfiENT /U05.00/ 

DEMONSTRATION PROGRAM TO PRINT DEMONSTRATION MESSAGE. 
RING BELL IF FG JOB SENDS A MESSAGE. 

.MCALL .RCVDt:» .PRINT 



.RCUDC 

.PRINT 



*ARfcA>tBUFFERf»400r*MSGIN fPGST REQUEST FOR MLSll 

*msg jprint demonstration mf'.i 

;and loop 



lAGE 



COMPLF.TION ROUTINE EN IE: RED UHFN FG SENDS MESSAHF 



. PR I N r 
.RCVDC 

RETURN 



*B£l L .KING BFLL IN RESPONSE I 

♦ AftEAi tBUFF'Ekf «400r tMSGTN fPOSI ANOTHER MFSSAGI. 
J AND RETURN FROM i:(IMI"'Lir 



I) MESSAGE 
RtOUESr 
ION ROOTINf 



dfll: 
msg : 



area: 
buffer: 



ASCII MESSAGES 
. NL1SI HEX 
.BY rE 7f.?00 



;ml-!>sagh that utngs bell 



. asi: 1 1 
. asc. 1 1 

.Asn i 

.BY IE 
.BLMJ A 
.END 



.'R T - 1 1 DEMONS TKA HON PROGRAM/ V', 1 L' 

/[I- INCORRECT! Y EM TED. THIS I 'i I HE LAS! IINE./ \ U 

/WILL DONE ./ 



;lhi argumeni area 

fKCVIit: MESSAGE AREA 



DEMOBG MACRO V05 
Symbol tahle 

ARFA 00O.'l?6R 
BELL OOOUOR 

. ABS. 000000 
00024? 
Krrcirs detected : 



00 S.tt.urddy OU-Jar. -83 11144 F'jae 1-1 



BUFFER 
MSli 



0001"! L'R 

oooi i::r 



MSGIN 000044R 
START OOOOOORG 



000 
001 



(RUrliGPL.ABS.nUR) 
(RUr I .LCL.REL.CON) 



*** Assembler st.3ti-it.u-' 



Uork flip 
Work file 
Sitae of uo 
Size of co 



eads : 

ite-.: 

f l If! 91R8 Words 

pool : IA128 Words 



Operating system: RT-11 



Elapsed time! 00:00105. 45 

OK I DEMOBG . DK I DEMOBG=riK : liE MOBG 



36 Pages) 
< 63 Pages) 



,V1 00000.5 



11.10.1.3 Link the Background Demonstration Program — Link the program 
DEMOBG. OBJ to produce an executable background program, 
DEMOBG.SAV. 

LINK DEMOBG© 



11.10.1.4 Run the Background Demonstration Program 

DEMOBG to check the results of the first exercise. 

, RUN DEMOBG© 

RT-11 DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED.. THIS IS THE LAST LINE, 

WELL DONE, 



Run the program 



If you did not delete the semicolon character, the last line will not print. 
Return to the monitor by typing two CTRL/Cs. 



(CTRIC) (CTRL/C ) 
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If you incorrectly edited the file, you can repeat the exercise, although you 
can continue without correcting the file. If you want to repeat the exercise, 
) begin by using the backup demonstration program. 

•RENAME SY: DEMOBG. BAK SY : DEMOBG . MAC© 

Then, repeat the editing procedure (see Section 11.10.1.1). 

11.10.2 Preparing the Foreground Demonstration Program 

To execute the foreground program, you must assemble the program 
DEMOFG.MAC, link it for the foreground, and then execute it in conjunc- 
tion with DEMOBG.SAV. 

DEMOFG.MAC is a small foreground program that sends a message every 

2 seconds to DEMOBG (running in the background), telling it to ring the 

) terminal bell. DEMOBG recognizes those messages and rings the bell once 

for each message sent. 

Although DEMOFG is always active, sending messages to the background 
every 2 seconds, this exercise can execute other programs in the back- 
ground besides DEMOBG. The circuit is complete and messages are suc- 
cessfully received and honored only when DEMOBG is active. During those 
periods when DEMOBG is not running, DEMOFG enters the messages in 
the monitor message queue. Once you restart DEMOBG in the background, 
) the system immediately releases all the messages queued since the last 

forced exit, resulting in many successive bell rings. When the queue is 
empty, the normal send/receive cycle resumes and the bell rings every 2 
seconds as each current message is sent and honored. 

11.10.2.1 Assemble the Foreground Demonstration Program — The fore- 
ground demonstration program, DEMOFG.MAC, is an assembly language 
source file which you must assemble and link before running. Assemble 
^ DEMOFG.MAC as follows: 



; 



'MACRO/LIST:LSTi DEMOFG© 



The output resulting from this MACRO command is an object file called 
DEMOFG.OBJ which resides on your system volume. 

11.10.2.2 Link the Foreground Demonstration Program — You must link the 
DEMOFG.OBJ file to produce an executable program. Use the /FORE- 
GROUND option to produce the load module DEMOFG.REL. The .REL file 
type tells the system that the file is a foreground program and should be 
run as a priority job. 

'LINK/FOREGROUND DEMOFG© 
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11.10.3 Run the Foreground and Background Demonstration 
Programs 

Type the following command to load and start DEMOFG.REL as the fore- 
ground job. 

,FRUN DEMOFG© 
F> 

FOREGROUND DEMONSTRATION PROGRAM 

SENDS A MESSAGE TO THE BACKGROUND PROGRAM DEM05G 
EMER Y 2 SECONDS i TELLING IT TO RING THE BELL. 
(CTRL/B) 

B> 

DEMOFG.REL is now running and queuing the message for DEMOBG 
every 2 seconds. Now execute DEMOBG.SAV in the background and re- 
ceive the messages. 

.RUN DEMOBG© 

(The bell rings quickly several times, then once every 2 seconds.) 

RT-li DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED, THIS IS THE LAST LINE. 

WELL DONE, 

Execute a DIRECTORY command in the background to obtain a directory 
listing. 



(CTRL/C) (CTRpcl 

(The bell stops ringing.) 

.DIRECTORY© 
d d - ID (il III - V / 

(The directory of the device DK prints on the terminal.) 



Rerun DEMOBG to collect all the foreground messages queued while the 
directory was printing. 

.RUN DEMOBG© 

(The bell rings several times in rapid succession, then rings once every 2 
seconds.) 

RT-il DEMONSTRATION PROGRAM 

IF INCORRECTLY EDITED- THIS IS THE LAST LINE. 

NELL DONE . 

(CTRL-C) (CTRL; C i 

(The bell stops ringing.) 
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Now, stop the foreground program and remove it from memory. 



gfRL/F") 
F> 

B> 

UNLOAD F© 



If you completed these exercises without error, your system has passed the 
minimal test and you can consider it successfully installed. 

11.11 Performing the System Generation Procedures 

If you have decided that you need RT-11 features that are available only if 
you generate your own monitor(s) and handlers, perform the system gener- 
ation procedures at this point. You should have thoroughly studied Chapter 
1 to make this decision and to establish that you can perform the system 
generation procedures on your particular hardware configuration. Read the 
RT-11 System Generation Guide for guidance in planning and performing 
system generation. 
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Appendix A 

Modifying SV1DUP to Recognize a Device Handler 



The Version 5 MDUP.MM, MDUP.MS, and MDUP.MT programs support 
the following devices: 



RK05 


RP02 


RK06 


RP03 


RK07 


RS03 


RL01 


RS04 


RL02 


RF11 



If you need to create MDUP for a disk or magtape not supported by RT-11 
(for which you have written your own handler), use MDUP.SAV as follows. 

Use the hardware version of the magtape handler and the standard (dis- 
tributed) single-job monitor. Your configuration must include at least 28K 
words of memory. Apply the following customization to the monitor. In the 
customization, xx is the name of the device on which the monitor resides. 

,R SlPPdH 

sxxrcRTllSJ.SYSlED 
Base? 0(H) 

Offset? 111BEE) 

Base Offset Old New? 

1 1 1 E 407 24 © 

0112 013704 1 2 7 4 (EH) 

001122 17757 G US) 



01124 0427 4 (CTRL/y ) (ret) 

* (5trI7c1 

Then copy the bootstrap: 

.COPY/BOOT xxnuRTHSJ.SYS on:® 



This procedure causes the system to use only 12K words of memory when 
booted. 



A-l 



Next apply the following customization to every handler to be supported by 
the version of MDUP you are building. In the customization, xx is the name 
of the device on which the handler resides, and yy is the name of the 
handler. 

, R SlPPdH 
* on : yy , SYSdl) 
Base? °© 

Offset? 17G@S) 

Base Offset Old N e_w_? 

1 7 B 

2 

2 2 



??-??'?'? o(RET) 

??'?'?'? -? 0(RET) 



nnnii' 



(CTRL/Y) (RJTfl 



: (CTRL/ C ) 



Now boot the monitor you have modified. Set the USR NOSWAP. Load all 
the handlers to be supported. Run MDUP.SAV and issue the following 
command. In the command, xx is the physical device name, and filnam.typ 
is your version of MDUP (MDUP.??). 

, R MDUP.SAVgH) 

* xx : f i In aw. typ = /H(H) 

MDUP.SAV creates the file filnam.typ and exits. 

If you make a typing error in the command line, use (CTRL/c) to abort 
MDUP.SAV and run MDUP.SAV again. If you get an insufficient memory 
error message, you cannot build MDUP with all the handlers loaded. Un- 
load one of the handlers, and run MDUP.SAV again. 
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Appendix B 

Loading Software Bootstraps 



If your hardware configuration procedure does not include a hardware boot- 
strap, use one of the following procedures for loading a software bootstrap. 
Find the section for bootstrapping your device, and use the switch register 
to deposit the bootstrap in memory. If your hardware configuration in- 
cludes a pushbutton console emulator instead of a switch register, follow 
the instructions in your hardware manual to load the appropriate bootstrap 
loader (listed in Tables B-l through B-9). 

B.1 Loading the RK11 (RK05) DECpack Bootstrap 

Deposit the basic RK11 (RK05) disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-l). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-l) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 

6. Set the contents for the next address (from Table B-l) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 



B-l 



Table B-l: RK11 (RK05) Bootstrap Loader 



Address 


Contents 


001000 


012700 


001002 


177406 


001004 


012710 


001006 


177400 


001010 


012740 


001012 


000005 


001014 


105710 


001016 


100376 


001020 


005007 



Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
in Table B-l. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.2 Loading the TC11 DECtape Bootstrap 

Deposit the basic TC11 DECtape bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-2). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-2) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 
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6. Set the contents for the next address (from Table B-2) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-2: TC11 Bootstrap Loader 



Address 


Contents 


001000 


012700 


001002 


177344 


001004 


012710 • 


001006 


177400 


001010 


012740 


001012 


004002 


001014 


005710 


001016 


100376 


001020 


012710 


001022 


000003 


001024 


105710 


001026 


100376 


001030 


012710 


001032 


000005 


001034 


105710 


001036 


100376 


001040 


005007 



) in Table B-2. 



Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

Compare the value in the data register with the value for that address 



5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 
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B.3 Loading the RX11 Bootstrap 

The procedure to deposit the RX11 disk bootstrap loader in memory de- 
pends on the type of processor ycu have. If your computer is a PDP-11V/03, 
PDP-11/03, or LSI-11, see the PDP-11 103 User's Manual for instructions. 
Otherwise deposit the RX11 disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-3). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-3) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 

6. Set the contents for the next address (from Table B-3) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Table B-3: RX11 Bootstrap Loader 



Address 


Contents 


001000 


005000 


001002 


012701 


001004 


177170 


001006 


105711 


001010 


001776 


001012 


012711 


001014 


000003 


001016 


005711 


001020 


001776 


001022 


100405 


, 001024 


105711 


001026 


100004 


001030 


116120 


001032 


000002 


001034 


000770 


001036 • 


000000 


001040 


005000 


001042 


000110 



Now verify that you deposited the bootstrap loader properly. 
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1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
in Table B-3. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.4 Loading the TJU16 or TM11 Magtape Bootstrap 

Deposit the basic TJU16 or TM11 magtape bootstrap loader in memory as 
follows: 

1. Set the ENABLE/HALT switch to HALT. 

2; Set the first address, 001000 or 010000, in the switch register (see 
Table B-^t or B-5). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B^ for TJU16 mag- 
tape or from Table B-5 for TM11 magtape) in the switch register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 

6. Set the contents for the next address (from Table B-4 or B-5) in the 
switch register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
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Table B-4: TJU16 Bootstrap Loader 



Address 


Contents 


001000 


012700 


001002 


172440 


001004 


012710 


001006 


000021 


001010 


012760 


001012 


001300 


001014 


000032 


001016 


012760 


001020 


177777 


001022 


000006 


001024 


012720 


001026 


000031 


001030 


105760 


001032 


000010 


001034 


100375 


001036 


012710 


001040 


177000 


001042 


012740 


001044 


000071 


001046 


032710 


001050 


100200 


001052 


001775 


001054 


100007 


001056 


022760 


001060 


001000 


001062 


000014 


001064 


001403 


001066 


000005 


001070 


000167 


001072 


177704 


001074 


005007 



Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000 or 010000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
in Table B-A or B-5. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 
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Table B-5: TM11 Bootstrap Loader 



Address 


Contents 


010000 


012700 


010002 


172524 


010004 


005310 


010006 


012740 


010010 


060011 


010012 


105710 


010014 


100376 


010016 


005710 


010020 


100767 


010022 


012710 


010024 


060003 


010026 


105710 


010030 


100376 


010032 


005710 


010034 


100777 


010036 


005007 



Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. If the magtape is not positioned at the load point, rewind the magtape 
manually. 

2. Set the starting address, 001000 or 010000, in the switch register. 

3. Press the LOAD ADDR switch. 

4. Set the ENABLE/HALT switch to ENABLE. 

5. Press the START switch. 

B.5 Loading the RK06/RK07 DECpack Bootstrap 

Deposit the basic RK06 or RK07 disk bootstrap loader in memory as fol- 
lows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-6). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-6) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 

6. Set the contents for the next address (from Table B-6) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
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Table B-6: RK06/RK07 Bootstrap Loader 



Address 



Contents 
RK06 



Contents 
RK07 



001000 


012701 


012701 


001002 


177440 


177440 


001004 


012711 


012711 


001006 


000003 


002003 


001010 


032711 


032711 


001012 


100200 


100200 


001014 


001775 


001775 


001016 


012761 


012761 


001020 


177400 


177400 


001022 


000002 


000002 


001024 


012711 


002021 


001026 


000021 


000021 


001030 


032711 


032711 


001032 


100200 


100200 


001034 


001775 


001775 


001036 


005007 


005007 



Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
, ■ in Table B-6. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
•deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.6 Loading the RL01/RL02 Disk Bootstrap 

Deposit the basic RL01/RL02 disk bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 001000, in the switch register (see Table B-7). 
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3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-7) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next 
address. 

6. Set the contents for the next address (from Table B-7) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
Table B-7: RL01/RL02 Bootstrap Loader 



Address 


Contents 


001000 


012701 


001002 


174400 


001004 


012761 


001006 


000013 


001010 


000004 


001012 


012711 


001014 


000004 


001016 


105711 


001020 


100376 


001022 


005061 


001024 


000002 


001026 


005061 


001030 


000004 


001032 


012761 


001034 


177400 


001036 


000006 


001040 


012711 


001042 


000014 


001044 


105711 


001046 


100376 


001050 


005007 



Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
in Table B-7. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 
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Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 001000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 

B.7 Loading the RX211 Bootstrap 

Deposit the basic RX211 bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address, 002000, in the switch register (see Table B-8). 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (from Table B-8) in the switch 
register. 

5. Lift the DEP switch. The computer automatically advances to the next- 
address. 

6. Set the contents for the next address (from Table B-8) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 
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Table B-8: RX211 Bootstrap Loader 



Address 


Contents 


002000 


012701 


002002 


177170 


002004 


012700 


002006 


100240 


002010 


005002 


002012 


012705 


002014 


000200 


002016 


012704 


002020 


000401 


002022 


012703 


002024 


177172 


002026 


030011 


002030 


001776 


002032 


100440 


002034 


012711 


002036 


000407 


002040 


030011 


002042 


001776 


002044 


100433 


002046 


110413 


002050 


000304 


002052 


030011 


002054 


001776 


002056 


110413 


002060 


000304 


002062 


030011 


002064 


001776 


002066 


100422 


002070 


012711 


002072 


000403 


002074 


030011 


002076 


001776 


002100 


100415 


002102 


010513 


002104 


030011 


002106 


001776 


002110 


100411 


002112 


010213 


002114 


060502 


002116 


060502 


002120 


122424 


002122 


120427 


002124 


000007 


002126 


003737 


002130 


005000 


002132 


005007 


002134 


000000 
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Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 002000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the value for that address 
in Table B-8. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all the 
addresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 002000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 



B.8 Loading the TSV05 Bootstrap Using MICRO-ODT 

Deposit the TSV05 bootstrap loader in memory as follows: 

1. Turn on your processor; if it is already on, halt it. 

2. At the console, type the first address in Table B-9 (7776) followed by a 
slash (/): 

7776/ 

The system responds by printing the contents of address 7776 (repre- 
sented below by xxxxxx) on the console: 

7776/ xxxxxx 

3. On the same line, type the first contents value from Table B-9 (46523) 
followed by a line feed. 

7776/ xxxxxx 46523© 

The system deposits the value you type and displays the next memory 
location. 

1 / 
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4. Type the contents for the next memory location (Table B-9) followed by 
a line feed. 

5. Repeat step 4 until you have deposited all the instructions. Then, type a 
carriage return. 

6. Finally, type: 

1 G 

The processor reads the software bootstrap from the magtape into mem- 
ory. The system prints the following prompt when it is finished: 

NSBOOT V05, xx 
* 

7. Respond to the asterisk (*) as described in Chapter 8. Wherever MM or 
MT appears in the instructions, substitute MS. 

Table B-9: TSV05 Bootstrap Loader 



Address 


Contents 


007776 


046523 


100000 


012701 


010002 


172522 


010004 


010102 


010006 


005000 


010010 


105711 


010012 


100376 


010014 


010704 


010016 


112737 


010020 


000200 


010022 


172523 


010024 


005242 


010026 


105711 


010030 


100376 


010032 


005711 


010034 


100761 


010036 


005007 



■9 Loading the TSV05 Bootstrap Using the Switch Register 

Deposit the TSV05 bootstrap loader in memory as follows: 

1. Set the ENABLE/HALT switch to HALT. 

2. Set the first address in Table B-9, 7776, in the switch register. 

3. Press the LOAD ADDR switch. 

4. Set the contents for the first address (46523 from Table B-9) in the 
switch register. 
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5. Lift the DEP switch. 

The computer automatically advances to the next address. 

6. Set the contents for the next address (from Table B-9) in the switch 
register. 

7. Lift the DEP switch. 

8. Repeat steps 6 and 7 until you have deposited all the instructions. 

Now verify that you deposited the bootstrap loader properly. 

1. Set the first address, 7776, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Press the EXAM switch to display the contents of that address in the 
data register. 

4. Compare the value in the data register with the contents value for that 
address in Table B-9. 

5. If the values are the same, press EXAM again to display the contents of 
the next address. If the values are not the same, repeat the entire 
procedure for depositing the bootstrap. Verify the contents of all ad- 
dresses in this way. If any instruction is incorrect, repeat the entire 
deposit procedure. 

Once you have correctly deposited the bootstrap in memory, start the com- 
puter as follows: 

1. Set the starting address, 10000, in the switch register. 

2. Press the LOAD ADDR switch. 

3. Set the ENABLE/HALT switch to ENABLE. 

4. Press the START switch. 
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Absolute base address p-sects 
changing number of, 2-25 

Auto installation file 
list of (table), 2-6 



BA.MAC, 2-6 

Bad block replacement 
in user- written handlers, 2-50 

Banner pages 
changing default width of, 2^8 

Base-line monitor 
See BL monitor 

BATCH.SAV system utility, 2-5 
modifying to save disk space, 
2-33 

BINCOM.SAV system utility, 2-4 

BL monitor 
description of, 1-6 
features of (table), 1-3 
vs SJ monitor (table), 1-6 

BL.ANS, 2-5 

Bootstrap 

installing on diskette, 6-8 
installing on RX02, 7-6 
installing on working system, 

3_9, 4_7, 5-7, 8-8 
loading software, B-l 
magtape 
• list of (table), 2-6 

Bootstrap loader 
RK05 address and contents, B-2 
RK.06 address and contents, B-8 
RK07 address and contents, B-8 
RL01 address and contents, B-9 
RL02 address and contents, B-9 
RX11 address and contents, B-4 
RX211 address and contents, 

B-ll 
TCll address and contents, B-3 
TJU16 address and contents, B-6 
TM11 address and contents, B-7 
TSV05 address and contents, 
B-13 

Bootstrap message 
changing, 2-42 
suppressing, 2-41 

Bootstrapping the system 
in less than 16K words, 2-37 

BSTRAP.MAC, 2-6 

BUP.SAV system utility, 2-A 



CAPS-11 

using to load files, 2-40 
Cartridges 
installing system to run on, 
3-1 to 3-16 
Clock rate 

specifying 50-cycle, 2-40 
Components 
arranging on working system, 
2-15 
CONFIG.COM, 2-8 
CONFIG.SAV, 2-8 
CONSOL.MAC, 2-8 
CR.MAC, 2-6 

CR.SYS device handler, 2-2 
CREF.SAV system utility, 2-4 
changing page listing length, 
2-53 
CT.MAC, 2-6 

CT.SYS device handler, 2-2 
CUSTOM.TXT, 2-8 
customization symbol values, 
2-22 
Customizations 
for distributed monitors, 2-22 

to 2-58 
software 
getting symbol values for, 
2-22 
50-cycle clock rate, 2-40 
restriction for Professional 
300 series, 2-40 

D keyboard command 

use of above background job, 
2-45 
DATIME.MAC, 2-8 
DATIME.SAV, 2-8 
DD.MAC, 2-6 

DD.SYS device handler, 2-2 
DDX.SYS device handler, 2-2 
Debuggers 

list of (table), 2-6 
DECtape II 

block locations on, 2-18 

changing CSR addresses in, 2-30 

changing vectors in, 2-30 

improving response time on, 
2-17 

installing system to run on, 
3-1 to 3-16 
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Default device 
assigning, 2-15 

changing for EDIT command, 2-44 
changing for FRUN command, 2-43 
changing for indirect command 

files, 2-42 
changing for QUEMAN, 2-45 
DEMOBG.MAC, 2-6 
DEMOED.TXT, 2-6 
DEMOF1.FOR, 2-6 
DEMOFG.MAC, 2-6 
Demonstration programs 
creating volumes for, 2-18 
list of (table), 2-6 
DEMOX1.MAC, 2-6 
Density 

changing for magtape, 2-33 
Device 

assigning default to data, 2-15 
Device handlers 
choosing for peripheral devices, 

2-11 
choosing for working system, 

2-11 
controller installed at 

nonstandard address, 2-31 
list of (table), 2-2 
renaming, 2-30 
user-written 
bad block replacement for, 

2-50 
for magtapes, 2-51 
when bootstrap doesn't install, 
2-30 
Devices 
installing nonstandard, 2-29 
sizes of (table), 2-9 
DF03 modem 

using with-VTCOM, 2-39 
DIAL command 

using with VTCOM, 2-39 
DIBOL 

LINK change requirement, 2-26 
DIFFERENCES/CHANGEBAR command, 

2-23 
DIR.SAV system utility, 2-4 
changing default number of 

columns in, 2-24 
changing default order of 
listings, 2-24 
DIRECTORY command, 2-9 
Directory listings 
changing default number of 

columns in, 2-24 
reading, 2-9 



sorting 
changing default of, 2-24 
Directory segments 
changing default number of, 
2-47 
Disk distribution kit 
backing up, 5-4, 6-3 
installing 
bootstrapping distribution 
volume, 5-3, 6-2 
installing on disk, 5-1 to 5-14 
installing on small device, 6-1 
to 6-16 
Diskettes 
installing system to run on, 

3-1 to 3-16, 6-1 to 6-16 
sizes of (table), 2-9 
Disks 
if SYSGEN required, 4-15 
installing system to run on, 

4-1 to 4-15, 5-1 to 5-14 
sizes of (table), 2-9 
DISMT1.COM, 2-5 
replacing magtape bootstrap in, 
2-52 
DISMT2.COM, 2-5 
Distribution kit 
disk 
installing on disk, 5-1 to 

5-14 
installing on small device, 
6-1 to 6-16 
files on (table), 2-2 
magtape 

installing on disk, 8-1 to 
8-16 
RX01 
installing on disk, 4-1 to 

4-15 
installing on small devices, 
3-1 to 3-16 
RX02 
installing on RX02, 7-1 to 
7-14 
RX50 

installing on MICRO/PDP-11, 

9-1 to 9-13 
installing on Professional 

325, 10-1 to 10-13 
installing on Professional 
350, 11-1 to 11-12 
DL.MAC, 2-6 

DL.SYS device handler, 2-2 
DLX.SYS device handler, 2-2 
DM.MAC, 2-6 
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DM.SYS device handler, 2-2 

DMX.SYS device handler, 2-2 

DP.MAC, 2-7 

DP.SYS device handler, 2-2 

DS.MAC, 2-7 

DS.SYS device handler, 2-2 

DT.MAC, 2-7 

DT.SYS device handler, 2-2 

DU.MAC, 2-7 

DU.SYS device handler, 2-2 

DUMP.SAV system utility, 2-4 

DUP.SAV system utility, 2-4 

DUX.SYS device handler, 2-2 

DW.MAC, 2-7 

DW.SYS device handler, 2-2 

DWX.SYS device handler, 2-2 

DX.MAC, 2-7 

DX.SYS device handler, 2-2 

DXX.SYS device handler, 2-3 

DY.MAC, 2-7 

DY.SYS device handler, 2-3 

DYX.SYS device handler, 2-3 

DZ.MAC, 2-7 

DZ.SYS device handler, 2-3 

DZX.SYS device handler, 2-3 

E keyboard command 
use of above background job, 
2-45 
EDIT keyboard command 

changing default file name for, 

2-45 
file type 

changing default, 2-44 
EDIT.SAV system utility, 2-A 
changing size of text window 

for, 2-27 
customizations for, 2-27 
with nonstandard ESCAPE codes, 
2-27 
Editors 

See Text editors 
EDTGBL.MAC, 2-7 
EL.MAC, 2-7 
ELCOPY.MAC, 2-7 
ELINIT.MAC, 2-7 
ELTASK.MAC, 2-7 
Errors 
fatal 
preventing reset from, 2-37 
ERROUT.OBJ, 2-7 
ERROUT.SAV, 2-5 
ERRTXT.MAC, 2-7 
Extended memory monitor 
See XM monitor 



Fatal errors 

preventing reset from, 2-37 
FB monitor 

description of, 1-6 
features of (table), 1-3 
FB.MAC, 2-7 
File types 
default 
changing for FRUN command, 

2-44 
changing for indirect command 
files, 2-43 
Files 

distributed 

list of (table), 2-2 
loading with CAPS-11, 2-^0 
size of 
setting upper limit on, 2-39 
FILEX.SAV system utility, 2-4 
Foreground/background monitor 

See FB monitor 
FORLIB.OBJ 
when combining with SYSLIB.OBJ, 
2-28 
FORMAT.SAV system utility, 2-4 
FRUN keyboard command 
changing default device for, 

2-43 
file type 
changing default, 2-44 
FSM.MAC, 2-7 

GETSTR.FOR, 2-6 
Graphics 

list of files for (table), 2-6 

Handler 

See Device handlers 
Handler files 

magtape (table), 2-33 
Hardware magtapes 

installing support for, 2-31 
HELP file 

changing default device for, 
2-49 

changing default file name for, 
2-49 
HELP package, 2-12 
Help text 

modifying, 2-35 
HELP.EXE 

creating from HELP.SAV, 2-35 
HELP.SAV system utility, 2-4 
HELP.TXT 

creating from HELP.SAV, 2-35 
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I/O page 
depositing in, 2-45 
examining, 2-45 
IND.SAV system utility, 2-4 
changing default device for, 

2-50 
changing default to, 2-53 
Indirect command files 
changing default device for, 

2-42 
file type 

changing default, 2-43 
nesting 

changing depth, 2-46 
start-up 
choosing for working system, 

2-14 
suppressing, 2-41 
suppressing echo, 2-42 
using IND with, 2-53 
Installation 
customization 
features available through, 
1-8 
disk distribution kit 
backing up, 5-4 to 5-5, 6-3 

to 6-5 
bootstrapping, 5-3, 6-2 
copying bootstrap to system 

volume, 5-5, 6-5 
initializing backup volume, 

5-4,6-3 
unprotecting backup volumes, 
5-5, 6-5 
disk distribution kit to disk, 

5-1 to 5-14 
disk distribution kit to small 

device, 6-1 to 6-16 
magtape distribution kit 
backing up, 8-4 to 8-6 
bootstrapping, 8-2 
magtape distribution kit to 
disk, 8-1 to 8-16 
if SYSGEN required, 8-16 
preparation for, 2-1 
procedure, 1-1 
reading path for, 1-18 
RX01 distribution kit 
backing up, 3-3 to 3-7, 4-3 

to 4-5 
bootstrapping, 3-2, 4-2 
copying bootstrap to system 

disk, 4-5 
copying bootstrap to system 
volume, 3-4 



if SYSGEN required, 3-16 
initializing backup disk, 4-3 
initializing backup volumes, 

3-3 
squeezing system volume, 3-4 
unprotecting backup volumes, 
3-6, 4-5 
RX01 distribution kit to disk, 

4-1 to 4-15 
RX01 distribution kit to small 

device, 3-1 to 3-16 
RX02 distribution kit 
bootstrapping, 7-2 
unprotecting distribution 
volume, 7-3 
RX02 distribution kit to RX02, 

7-1 to 7-14 
RX50 
copying distribution 
diskettes onto disk, 9-4, 
11-4 
copying system diskette onto 
disk, 9-3, 11-4 
RX50 distribution kit 
bootstrapping, 9-2, 9-4, 10-2, 
11-2, 11-4 
survey of procedures, 2-1 
test of for MICRO/PDP-11 

working system, 9-8 to 9-13 
test of for Professional 325 
working system, 10-8 to 
10-13 
test of for Professional 350 
working system, 11-7 to 
11-12 
test of working system on disk, 
4-10 to 4-15, 5-10 to 5-14, 
8-10 to 8-16 
test of working system on RX02, 

7-8 to 7-13 
test of working system on small 
device, 3-11 to 3-16, 6-11 
to 6-16 
Installation worksheet, 2-58 
Introduction to RT-11 
creating volumes for, 2-18 
files required for, 2-12 
IVP.MAP, 2-6 



K52.SAV system utility, 2-4 
KED.SAV system utility, 2-4 
modifying default file type, 
2-56 
KEX.SAV system utility 
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limiting memory requested by, 
2-54 

Keypad editor 
See K52.SAV system utility 
See KED.SAV system utility 

KMON.MAC, 2-7 

KMOVLY.MAC, 2-7 

LD.MAC, 2-7 

LD.SYS device handler, 2-3 
Also see Logical disk files 
used with magtape, 2-52 
LDX.SYS device handler, 2-3 
LIBR.SAV system utility, 2-4 
Libraries 

list of (table), 2-6 
LIBRARY command, 2-11 
Library modules 
increasing number of for LINK, 
2-25 
Line printer handlers 
changing GSR addresses in, 2-30 
changing vectors in, 2-30 
choosing for working system, 
2-13 
LINK.SAV system utility, 2-4 
changing default output to 

132-columns, 2-57 
changing size of library module 

list, 2-25 
changing size of library module 

list of, 2-25 
modifying listing page length, 

2-49 
modifying to change default 
SYSLIB device, 2-34 
Load maps 
changing default page length 
for, 2-49 
Logical disk files 

changing default file type, 2-52 
LP.MAC, 2-7 

LP.SYS device handler, 2-3 
choosing, 2-13 
renaming, 2-13 
LPX.SYS device handler, 2-3 
LS.MAC, 2-7 

LS.SYS device handler, 2-3 
choosing, 2-13 
renaming, 2-13 
LSX.SYS device handler, 2-3 

MACRO assembler 
files required for, 2-13 



MACRO.SAV system utility, 2-4 
changing default 

.ENABLE/.DISABLE options, 
2-55 
changing default .LIST/.NLIST 

options, 2-54 
changing page listing length, 
2-53 
Magtape distribution kit 
backing up, 8-4 
installing 
bootstrapping distribution 
volume, 8-2 
installing on disk, 8-1 to 8-16 
Magtapes 
changing parity and density of, 

2-33 
handler files (table), 2-33 
hardware 

installing support for, 2-31 
replacing bootstrap for in 
DISMT1.COM, 2-52 
user-written handlers for, 2-51 
MBOOT.BOT, 2-6 
MBOT16.BOT, 2-6 
MDUP.MM system utility, 2-4 

device support, A-l 
MDUP.MS system utility, 2-4 

device support, A-l 
MDUP.MT system utility, 2-4 

device support, A-l 
MDUP.SAV system utility, 2-4 
nonstandard device 

support,modifying for, A-l 
Media 

calculating sufficient, 2-21 
Memory 
running in less than available, 

2-37 
size of 

setting upper limit on, 2-41 
MICRO/PDP-11 

installing on, 9-1 to 9-13 
if SYSGEN required, 9-13 
MM.SYS device handler, 2-3 
MMHD.SYS hardware magtape 

handler, 2-32 
MMHDX.SYS hardware magtape 

handler, 2-32 
MMX.SYS device handler, 2-3 
Monitor map files 
customization symbol values, 
2-22 
Monitors 



Index-5 



See also BL monitor, FB 

monitor, SJ monitor, and XM 
monitor 
customizations available for 

descriptions of, 2-22 to 2-58 
customizations available for 

(table), 1-8 
depositing in, 2-45 
distributed 
choice of, 1-3 
features available in (table), 

1-3 
list of (table), 2-2 
examining, 2-45 
selection of for working system, 

2-10 
system generation options 
available for (table), 1-15 
MS.SYS device handler, 2-3 
MSBOOT.BOT, 2-6 
MSCP disks 
changing CRS addresses in, 2-30 
changing vectors in, 2-30 
MSHD.SYS hardware magtape handler, 

2-32 
MSHDX.SYS hardware magtape 

handler, 2-32 
MSX.SYS device handler, 2-3 
MT.SYS device handler, 2-3 
MTHD.SYS hardware magtape handler, 

2-32 
MTHDX.SYS hardware magtape 

handler, 2-32 
MTTEMT.MAC, 2-7 
MTTINT.MAC, 2-7 
MTX.SYS device handler, 2-3 

Nesting depth 
indirect command files 
changing, 2-46 
NL.MAC, 2-7 

NL.SYS device handler, 2-3 
NLX.SYS device handler, 2-3 



ODT.OBJ, 2-6 

OHANDL overlay handler, 2-11 

Output device 

changing default to terminal, 
2-23 
Output ring buffer 

increasing space requirement in 
to resume job, 2-^46 
Overlaid utilities 

list of, 2-16 



P-sects 
absolute base address 

changing number of, 2-25 
Parity 

changing for magtape, 2-33 
PAT.SAV system utility, 2-4 
PC.MAC, 2-7 

PC.SYS device handler, 2-3 
PD.MAC, 2-7 

PD.SYS device handler, 2-3 
PI.SYS device handler, 2-3 
PIP.SAV system utility, 2-4 
PIX.SYS device handler, 2-3 
Professional 325 
installing on, 10-1 to 10-13 

bootstrap, 10-5 

creating working system, 10-3 

customizing, 10-6 

if SYSGEN required, 10-13 
Professional 350 
installing on, 11-1 to 11-12 

if SYSGEN required, 11-12 
Program sections 

See P-sects 
PUTSTR.FOR, 2-6 

QUEMAN.SAV system utility, 2-5 
changing default device for, 

2-45 
choosing for working system, 
2-13 
O.UEUE work file 

changing size of, 2-26 
QUEUE.REL system utility, 2-5 
changing size of work file, 

2-26 
choosing for working system, 
2-13 
QUEUE.SAV system utility 
allowing first form feed, 2-52 

RA80 disk 

device name, 2-9 

size of, 2-9 
RC25 disk 

device name, 2-9 

size of, 2-9 
RD50 disk 

device name, 2-9 

size of, 2-9 
RD51 disk 

device name, 2-9 

size of, 2-9 
Reading path 

for installation, 1-18 
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RESORC.SAV system utility, 2-5 
RF.MAC, 2-7 

RF.SYS device handler, 2-3 
Ring buffer 
output 

increasing space requirement 
in to resume job, 2-46 
RK.MAC, 2-7 

RK.SYS device handler, 2-3 
RK05 

loading bootstrap, B-l 
RK05 disk 
device name, 2-9 
size of, 2-9 
RK06 

loading bootstrap, B-7 
RK06/RK07 disk 
device name, 2-9 
size of, 2-9 
RK07 

loading bootstrap, B-7 
RK11 DECpack 

See RK05 
RKX.SYS device handler, 2-3 
RL01 

loading bootstrap, B-8 
RL01/RL02 disk 
device name, 2-9 
size of, 2-9 
RL02 

loading bootstrap, B-8 
RMONFB.MAC, 2-8 
RMONSJ.MAC, 2-8 
RP03 magtape support, 2-33 
RT11AI.SYS monitor, 2-2 
RT11BL.SYS monitor, 2-2 
RT11PI.SYS monitor, 2-2 
RT11SJ.SYS monitor, 2-2 
RTBL.MAP, 2-5 
RTMON.REL, 2-8 
RTSJ.MAP, 2-5 
RTXM.MAP, 2-5 
RX01 diskette 
device name, 2-9 
initializing and formatting, 

6-7 
size of, 2-9 
RX01 distribution kit 
backing up, 3-3, 4-3 
installing 
bootstrapping distribution 
volume, 3-2, 4-2 
installing on disk, 4-1 to 4-15 
installing on small devices, 
3-1 to 3-16 



RX02 diskette 
device name, 2-9 
initializing and formatting, 

6-7 
size of, 2-9 
RX02 distribution kit 
installing 
bootstrapping distribution 
volume, 7-2 
installing on RX02, 7-1 to 7-14 
if SYSGEN required, 7-14 
RX11 

loading bootstrap, B-4 
RX211 

loading bootstrap, B-10 
RX50 diskette 
device name, 2-9 
initializing, 6-6 
size of, 2-9 
RX50 distribution kit 
installing 
bootstrapping system disk, 

9-4, 11-4 
bootstrapping system diskette, 

9-2, 10-2, 11-2 
copying distribution 
diskettes onto disk, 9-4, 
11-5 
copying system diskette onto 
disk, 9-3, 11-4 
installing on MICRO/PDP-11, 9-1 

to 9-13 
installing on Professional 325, 

10-1 to 10-13 
installing on Professional 350, 
11-1 to 11-12 

.SETTOP programmed request 

used with KEX, 2-54 
SETUP.SAV system utility, 2-5 
Single-job monitor 

See SJ monitor 
SIPP.SAV system utility, 2-5 

installing customization symbol 
values, 2-22 
SJ monitor 

description of, 1-6 

features of (table), 1-3 
SJ.MAC, 2-8 
SJFB.ANS, 2-5 
SL.SYS pseudohandler, 2-4 
SLP.SAV system utility, 2-5 
SLX.SYS pseudohandler, 2-4 
Software customizations, 2-22 to 
2-58 
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choosing, 2-21 

getting symbol values for, 2-22 
Software kit 

distributed components of, 2-2 
Software updates 

backing up magtape, 8-6 

installing, 2-20, 3-7, 4-6, 5-6, 
6-5, 7-4, 8-6, 9-3, 10-3, 
11-3 
Source files 

choosing for working system, 
2-14 

list of (table), 2-6 
SP.MAC, 2-8 

SP.SYS device handler, 2-3 
SPLIT.SAV, 2-8 
SPOOL.REL system utility, 2-5 

changing output device, 2-57 

changing work file size, 2-56 

choosing for working system, 
2-13 
SPOOL.SYS 

created by SPOOL.REL, 2-56 
SPX.SYS device handler, 2-3 
SRCCOM.SAV system utility, 2-5 

changing insertion/deletion 
characters used by, 2-22 

/D option, 2-23 
STARTA.COM, 2-6 
STARTF.COM, 2-5 
STARTS.COM, 2-5 
STARTX.COM, 2-5 
Subroutines 

list of (table), 2-6 
SWAP.SYS 

need for, 2-10 
SYSGEN.COM, 2-5 
SYSLIB.OBJ system library, 2-6 

changing default device of, 2-34 

extracting overlay handlers 
from, 2-28 

need for, 2-11 
SYSMAC.SML system MACRO library, 

2-5 
System generation 

features available (table), 1-15 

list of files for (table), 2-5 

need for, 1-14 
System Library 

See SYSLIB.OBJ 
System utilities 

minimum on system volume, 2-20 
System volume 

creating, 2-18 



example of, 2-17 
including overlaid utilities, 

2-16 
limiting components on, 2-20 

TC11 

loading bootstrap, B-2 
TERMID.SAV, 2-6 
Terminal 

changing default output to, 
2-23 
Text editors 

choosing for working system, 
2-14 
TJ.MAC, 2-8 
TJU16 

loading bootstrap, B-5 
TM.MAC, 2-8 
TM11 

loading bootstrap, B-5 
TRANSF.SAV system utility, 2-5 
TRMTBL.MAC, 2-8 
TS.MAC, 2-8 
TSV05 

loading bootstrap 
MICRO-ODT, B-12 
switch register, B-13 
TT.MAC, 2-8 
TT.SYS device handler, 2-3 

UCL.SAV system utility, 2-5 
Unsupported software 

list of (table), 2-8 
Updates 

backing up magtape, 8-6 

installing, 2-20, 3-7, 4-6, 5-6, 
6-5, 7-4, 8-6, 9-3, 10-3, 
11-3 
USR.MAC, 2-8 
Utilities volume 

creating a, 2-16 

example of, 2-17 
Utility programs 

choosing for working system, 
2-15 

creating volume for, 2-16 

V5NOTE.TXT, 2-8 
V5USER.TXT, 2-5 
VBGEXE.SAV, 2-8 
VDT.OBJ, 2-6 
Vectors 
VT11/VS60 
changing, 2-23 
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VERIFY.COM, 2-6 

VHANDL overlay handler, 2-11 

Virtual memory 

device name, 2-9 

size of, 2-9 
VM.MAC, 2-8 
VM.SYS device handler, 2-3 
VMX.SYS device handler, 2-3 
Volumes 

system 
creating, 2-18 
VT11/VS60 

changing vector address, 2-23 
VTCOM.REL system utility, 2-5 

setting default DIAL string, 
2-39 
VTCOM.SAV system utility, 2-5 

setting default DIAL string, 
2-39 
VTHDLR.OBJ, 2-6 
VTMAC.MAC, 2-6, 2-8 

Working system 

arrangement of components for, 

2-15 
on disk 
backing up, 4-8 to 4-9, 5-9, 

8-9 to 8-10 
compressing, 4-7, 5-8, 8-8 
creating from disk, 5-6 
creating from magtape, 8-7 
creating from RX01, 4-6 
installing bootstrap on, 4-7, 

5-7 
installing customizations on, 

4-7, 5-8, 8-8 
protecting, 4-8 
test of installation, 4-10 to 

4-15, 5-10 to 5-14, 8-10 

to 8-16 
on MICRO/PDP-11 
backing up, 9-6 to 9-8 
compressing, 9-6 
creating, 9-5 
installing customizations on, 

9-5 
testing installation, 9-8 to 

9-13 



on Professional 325, 10-3 
backing up, 10-7 
testing installation, 10-8 to 

10-13 
unprotecting, 10-6 
on Professional 350 
backing up, 11-6 
compressing, 11-5 
creating, 11-5 
installing customizations on, 

11-5 
testing installation, 11-7 to 
11-12 
on RX02 
backing up, 7-8 
compressing, 7-7 
creating from RX02, 7-4 to 

7-6 
installing bootstrap on, 7-6 
installing customizations on, 

7-7 
test of installation, 7-8 to 
7-13 
on small device 
backing up, 3-10, 6-10 
compressing, 3-10, 6-9 
creating from disk, 6-6 to 

6-7 
creating from RX01, 3-7 
installing bootstrap on, 3-9, 

6-8 
installing customizations on, 

3-9, 6-9 
test of installation, 3-11 to 
3-16, 6-11 to 6-16 
selecting components for, 2-8 

XC.MAC, 2-8 

XC.SYS device handler, 2-4 

XCX.SYS device handler, 2-4 

XL.MAC, 2-8 

XLX.SYS device handler, 2-4 

XM monitor 
description of, 1-7 
features of (table), 1-3 

XM.ANS, 2-5 

XM.MAC, 2-8 

XMSUBS.MAC, 2-8 
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HOW TO ORDER 
ADDITIONAL DOCUMENTATION 



From 



Chicago 



Call 



312-640-5612 

8:15 am to 5:00 pm CT 



Write 



Digital Equipment Corporation 
Accessories & Supplies Center 
1050 East Remington Road 
Schaumburg, IL 60195 



San Francisco 
Alaska, Hawaii 



New Hampshire 



Rest of U.S.A., 
Puerto Rico* 



408-734-4915 
8:15 am to 5:00pm PT 

603-884-6660 

8:30am to 600 pm ET 

or 408-734-4915 

8:15 am to 5 00 pm PT 



603-884-6660 
8:30 am to 6:00 pm ET 

1-800-258-1710 
8:30 am to 6:00 pm ET 



Digital Equipment Corporation 
Accessories & Supplies Center 
632 Caribbean Drive 
Sunnyvale, CA 94086 



Digital Equipment Corporation 
Accessories & Supplies Center 
P.O. Box CS2008 
Nashua, NH 03061 



•Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 80^-754-7575) 



Canada 
British Columbia 

Ottawa-Hull 

Elsewhere 



1-800-267-6146 
8:00 am to 5:00 pm ET 

613-234-7726 
8:00 am to 5:00 pm ET 

112-800-267-6146 

8:00 am to 5:00 pm ET 



Digital Equipment of Canada Ltd 
940 Belfast Road 
Ottawa, Ontario K1G 4C2 
Attn: A&SG Business Manager 



Elsewhere 



Digital Equipment Corporation 
A&SG Business Manager* 



'c/o DIGITAL'S local subsidiary or approved distributor 



RT-11 

Installation Guide 

AA-H376C-TC 

READER'S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

— Assembly language programmer 

— Higher-level language programmer 

— Occasional programmer (experienced) 

— User with little programming experience 

— Student programmer 

— Other (please specify) 



Name : Date . 



Organization Telephone . 

Street 



City State Zip Code . 



or Country 



— Do Not Tear — Fold Here and Tape 
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United States 
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MAYNARD, MA 01754-2571 
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